Skip to main content
POST
Upload verification documents

Authorizations

Authorization
string
header
required

API key sent in the Authorization header, with no Bearer prefix.

Path Parameters

organizationId
string<uuid>
required

The organization this call acts for: your API key's organization or one of its customer organizations. Any other id returns 404 not-found.

Body

multipart/form-data
id_front
file

Front of the identity document, or its only side. JPEG, PNG or PDF, up to 10 MB. At least one of id_front, id_back, proof_of_address or tax_document must be sent.

id_back
file

Back of the identity document, where it has two sides. JPEG, PNG or PDF, up to 10 MB. Required whenever id_type is id_card or drivers_license, and refused for passport, which is single-sided. Both sides go in the same request: sending this without id_front is a 400, so a back cannot be added to an earlier upload on its own.

id_type
enum<string>

Which identity document the id_* parts are. Required whenever one is sent. Case-sensitive: send the value exactly as listed.

Available options:
ID_CARD,
PASSPORT,
DRIVERS
proof_of_address
file

A document evidencing the customer's address. JPEG, PNG or PDF, up to 10 MB. Only accepted once the proof-of-address requirement is outstanding: sent earlier it is accepted with a 202 and then dropped, leaving the requirement outstanding.

proof_of_address_type
enum<string>
default:UTILITY_BILL

Which kind of address document it is. Case-sensitive: send the value exactly as listed.

Available options:
UTILITY_BILL,
BANK_STATEMENT,
TAX_BILL,
EMPLOYMENT_CERTIFICATE,
PROPERTY_DEED,
INVOICE
tax_document
file

A tax document, where the customer's country requires one; in Mexico, the Constancia de Situación Fiscal. JPEG, PNG or PDF, up to 10 MB. Not recorded for a customer whose verification does not collect one. See Country-specific requirements.

country
string

Issuing country of these documents, as an ISO 3166-1 alpha-3 code. Only needed when the customer's profile has no country yet.

Example:

"MEX"

Response

Accepted and being applied. The customer's current verification status is returned.

Where the customer's verification stands after a write. status is the same value GET /organization/{organizationId}/kyc reports.

organizationId
string<uuid>
required
status
enum<string>
required
  • notStarted: verification has not started.
  • inProgress: the customer started but has not submitted everything.
  • submitted: submitted and waiting for review.
  • approved: cleared.
  • denied: rejected, or a previous approval was revoked.
Available options:
notStarted,
inProgress,
submitted,
approved,
denied