Skip to main content
Export Results
curl --request GET \
  --url https://api.example.com/exports/{jobId}
Generate and download PDF reports of completed KYC validation results. Reports include all scan results, matches, and metadata from the original screening.

​
Endpoint

GET /exports/{jobId}

​
Authentication

Requires kyc:export permission. Include your Bearer token in the Authorization header.

​
Path Parameters

​
Description

This endpoint generates a PDF report for a completed KYC check and returns a presigned URL for downloading the report. The PDF includes:
  • Entity information checked
  • Lists scanned
  • Match results (if any)
  • Confidence scores
  • Timestamps
  • Processing metadata

​
Request Example

curl "https://stg.kyc.legaltalent.ai/exports/abc-123-def" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"

​
Response Format

​
Success Response

{
  "request_id": "abc-123-def",
  "bucket": "kyc-exports-develop",
  "key": "exports/tenants/tenant123/abc-123-def.pdf",
  "presigned_url": "https://kyc-exports-develop.s3.amazonaws.com/exports/tenants/tenant123/abc-123-def.pdf?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE&X-Amz-Date=20241122T103000Z&X-Amz-Expires=3600&X-Amz-Signature=abc123def456"
}

​
Response Fields

FieldTypeDescription
request_idstringThe job ID that was requested
bucketstringS3 bucket name where PDF is stored
keystringS3 object key (path)
presigned_urlstringPre-signed URL valid for 1 hour (default)

​
Presigned URL Details

  • Validity: 1 hour by default
  • Access: Direct download via HTTPS
  • Format: PDF document
  • Size: Typically 50-500 KB depending on match count

​
Usage Examples

​
Download PDF with cURL

# Get presigned URL
RESPONSE=$(curl -X GET "https://stg.kyc.legaltalent.ai/exports/abc-123-def" \
  -H "Authorization: Bearer YOUR_TOKEN")

# Extract presigned URL (using jq)
URL=$(echo $RESPONSE | jq -r '.presigned_url')

# Download the PDF
curl -o report.pdf "$URL"

​
Python Example

import requests

job_id = "abc-123-def"
token = "YOUR_TOKEN"

# Get presigned URL
response = requests.get(
    f"https://stg.kyc.legaltalent.ai/exports/{job_id}",
    headers={"Authorization": f"Bearer {token}"}
)

if response.status_code == 200:
    data = response.json()
    presigned_url = data["presigned_url"]
    
    # Download PDF
    pdf_response = requests.get(presigned_url)
    with open("kyc_report.pdf", "wb") as f:
        f.write(pdf_response.content)
    
    print("PDF downloaded successfully")
else:
    print(f"Error: {response.json()}")

​
JavaScript/Fetch Example

const jobId = "abc-123-def";
const token = "YOUR_TOKEN";

async function downloadReport() {
  // Get presigned URL
  const response = await fetch(
    `https://stg.kyc.legaltalent.ai/exports/${jobId}`,
    {
      method: "GET",
      headers: {
        "Authorization": `Bearer ${token}`,
        "Accept": "application/json"
      }
    }
  );

  const data = await response.json();
  
  if (response.ok) {
    // Download PDF in browser
    window.location.href = data.presigned_url;
    // Or download programmatically:
    // const pdfResponse = await fetch(data.presigned_url);
    // const blob = await pdfResponse.blob();
    // const url = window.URL.createObjectURL(blob);
    // const a = document.createElement('a');
    // a.href = url;
    // a.download = 'kyc_report.pdf';
    // a.click();
  } else {
    console.error("Error:", data.error);
  }
}

​
Error Responses

​
400 Bad Request - Missing Job ID

{
  "error": "Missing request_id/job_id"
}

​
400 Bad Request - Missing Tenant ID

{
  "error": "Missing tenant_id"
}

​
404 Not Found

{
  "error": "Record not found"
}
This occurs when:
  • The jobId is incorrect
  • The record has been deleted
  • The job never completed successfully
  • The job belongs to a different tenant

​
500 Internal Server Error

{
  "error": "Internal error",
  "message": "Detailed error description"
}

​
Status Codes

CodeDescription
200Success - PDF generated and presigned URL returned
400Bad Request - Invalid parameters
401Unauthorized - Missing or invalid token
403Forbidden - Insufficient permissions
404Not Found - Job not found
500Internal Server Error

​
PDF Report Contents

The generated PDF includes:
  1. Header Section
    • Report generation timestamp
    • Job ID
    • Entity name checked
  2. Summary Section
    • Total lists checked
    • Match status (Yes/No)
    • Overall risk level
  3. Entity Information
    • Full name
    • Document ID (if provided)
    • Nationality (if provided)
    • Other identifiers
  4. Results by List
    • List name
    • Match status
    • Match count
    • Confidence scores
    • Match details (entity names, programs)
  5. Metadata
    • Processing time
    • Search type used
    • Timestamp

​
Notes

  • PDFs are generated on-demand when requested
  • Reports are stored in S3 for 90 days (configurable)
  • Presigned URLs expire after 1 hour
  • Each tenant’s reports are stored in separate S3 prefixes for data isolation
  • Large reports (many matches) may take longer to generate

​
Workflow

  1. Perform KYC check via POST /kyc
  2. Save the job_id from the response
  3. Request export via GET /exports/{jobId}
  4. Download PDF from the presigned URL
  5. Presigned URL is valid for 1 hour