Retrieve a Document - Anton Payments

GET

/

v1

/

documents

/

{id}

Retrieve a document

curl --request GET \
  --url https://api.antonpayments.com/v1/documents/{id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "<string>",
  "merchant_id": "<string>",
  "category": "<string>",
  "status": "uploaded",
  "file_name": "<string>",
  "content_type": "application/pdf",
  "file_size": 123,
  "created_at": "2026-04-15T14:30:00Z",
  "updated_at": "2026-04-15T14:30:00Z",
  "entity_type": "application",
  "entity_id": "<string>",
  "uploaded_by": "<string>",
  "description": "<string>",
  "reviewed_by": "<string>",
  "reviewed_at": "2026-04-15T14:30:00Z",
  "rejection_reason": "<string>",
  "expires_at": "2026-04-15T14:30:00Z"
}

Authorizations

Authorization

string

header

required

API keys are opaque strings prefixed by environment:

ak_live_* — production keys, accepted only on api.antonpayments.com.
ak_test_* — sandbox keys, accepted only on api.antonpayments.dev.

Include your key in the Authorization header: Bearer ak_test_....

Path Parameters

id

string

required

Pattern: ^doc_[a-zA-Z0-9]+$

Response

Document.

A supporting document uploaded by the merchant — KYB evidence, beneficiary identity verification, RFI supporting material. Bytes live in S3; this record is metadata only.

id

string

required

Pattern: ^doc_[a-zA-Z0-9]+$

merchant_id

string

required

Pattern: ^mer_[a-zA-Z0-9]+$

category

string

required

Logical category — e.g. kyb_incorporation, beneficiary_id, rfi_evidence.

status

enum<string>

required

Available options:

uploaded,

accepted,

rejected

file_name

string

required

content_type

string

required

MIME type.

Example:

"application/pdf"

file_size

integer

required

Bytes.

created_at

string<date-time>

required

RFC 3339 / ISO 8601 timestamp in UTC.

Example:

"2026-04-15T14:30:00Z"

updated_at

string<date-time>

required

RFC 3339 / ISO 8601 timestamp in UTC.

Example:

"2026-04-15T14:30:00Z"

entity_type

enum<string>

Available options:

application,

beneficiary,

rfi

entity_id

string

uploaded_by

string

description

string

reviewed_by

string

reviewed_at

string<date-time>

RFC 3339 / ISO 8601 timestamp in UTC.

Example:

"2026-04-15T14:30:00Z"

rejection_reason

string

expires_at

string<date-time>

Document expiry (e.g. passport expiry).

Example:

"2026-04-15T14:30:00Z"

Get a Download URLReturn a short-lived pre-signed URL the merchant can GET to fetch the document's bytes. The URL typically expires within a few minutes.

⌘I

Retrieve a document

curl --request GET \
  --url https://api.antonpayments.com/v1/documents/{id} \
  --header 'Authorization: Bearer <token>'

{
  "id": "<string>",
  "merchant_id": "<string>",
  "category": "<string>",
  "status": "uploaded",
  "file_name": "<string>",
  "content_type": "application/pdf",
  "file_size": 123,
  "created_at": "2026-04-15T14:30:00Z",
  "updated_at": "2026-04-15T14:30:00Z",
  "entity_type": "application",
  "entity_id": "<string>",
  "uploaded_by": "<string>",
  "description": "<string>",
  "reviewed_by": "<string>",
  "reviewed_at": "2026-04-15T14:30:00Z",
  "rejection_reason": "<string>",
  "expires_at": "2026-04-15T14:30:00Z"
}