Sign in

v1

latestOpenAPI 3.1.02026-07-241653251.3 MB
Query Participants

Download participant document

Returns a single KYC document with a presigned S3 URL for downloading. The presigned URL expires after 15 minutes. Returns 404 if the document is not found or does not belong to the participant.

get/participant/{participant_code}/full_info/documents/{document_id}/download

Path parameters

participant_codestring required
Example:ABCDEF

Unique participant identifier. Always 6 uppercase alphanumeric characters.

document_idstring required
Example:e39e7b6a908e397dac50e461eb2d284820214ca2cb3c4aa9aeb9dfc1873332a0

Unique identifier of the document to download. Returned by GET /participant/{participant_code}/full_info/document_metadata on each document entry.

Headers

X-SCX-SIGNEDstring required

HMAC-SHA256 signature of the request, base64-encoded. See the Authentication guide for the exact signing formula.

X-SCX-TIMESTAMPstring required
Example:1678901234

Current Unix timestamp in seconds. Must be within 60 seconds of server time or the request is rejected.

Response

Successfully retrieved document with presigned download URL. The signed_url field contains a presigned S3 URL valid for 15 minutes.

Example response

{
  "message": {
    "document_id": "e39e7b6a908e397dac50e461eb2d284820214ca2cb3c4aa9aeb9dfc1873332a0",
    "file_name": "passport.pdf",
    "participant_code": "ABCDEF",
    "document_type": "us_passport",
    "created_at": 1678901234567,
    "signed_url": "https://s3.amazonaws.com/bucket/documents/abc123?X-Amz-Expires=900&...",
    "mime_type": "application/pdf"
  }
}