Skip to main content
POST
Upload an individual document

Authorizations

ā€‹
X-Application-Token
string
header
required

Application-specific token for public URL access. Generated when a customer is created. Provides access to a single application without requiring an API key. Token is valid for 90 days and rate-limited to 250 requests per hour.

Headers

ā€‹
x-idempotency-key
string<uuid>
required

Unique key (UUID) to ensure request idempotency on POST, PUT and PATCH requests.

A key is scoped to your client, the HTTP method and the path, and is remembered for 24 hours after a successful (below 400) response. Repeating the same request (same JSON body, whatever the key order or whitespace) with the same key within that window returns the original response with X-Idempotent-Replayed: true instead of executing the request again. Using the same key on the same endpoint with a different body returns 422 with problem type idempotency-key-reused; the request is not executed. Error responses (4xx and 5xx) are not remembered, so a request refused for a fixable reason can be corrected and retried under the same key. Request bodies that are not JSON (for example file uploads) are not compared.

Path Parameters

ā€‹
application_id
string
required

The unique identifier for the application KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Pattern: ^[0-9A-Za-z]{27}$
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

ā€‹
individual_id
string
required

The unique identifier for the individual KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Pattern: ^[0-9A-Za-z]{27}$
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"

Body

application/json

Request to upload a document for an individual (identity or EDD document). For identity documents (passport, drivers_license_front, drivers_license_back, residence_permit_front, residence_permit_back, national_id_front, national_id_back), id_number is required.

ā€‹
type
enum<string>
required

Type of document that can be uploaded for individuals (identity documents + EDD documents).

Identity documents: passport (single-sided), drivers_license_front + drivers_license_back, residence_permit_front + residence_permit_back, national_id_front + national_id_back. Two-sided documents need both sides before the identity requirement is met when you upload them here. Documents imported from a verification provider are the exception: a Sumsub share token is issued for an applicant that provider already verified against its own per-country rules, and some countries are one-sided there (a German driver's license has no back), so an imported identity document satisfies the requirement on its own.

national_id_front / national_id_back are accepted only for national ID cards issued by Colombia (country = CO); other issuing countries are rejected. An individual who submits a national ID card is always reviewed by a compliance analyst and is never approved automatically.

other is a supporting document of no fixed type, such as a file attached to the answer to a request for information on an individual application.

Available options:
passport,
drivers_license_front,
drivers_license_back,
residence_permit_front,
residence_permit_back,
national_id_front,
national_id_back,
proof_of_address,
bank_statement,
utility_bill,
source_of_wealth,
payslip,
employment_contract,
income_verification_letter,
savings_statement,
crypto_statement,
investment_statement,
other
Example:

"passport"

ā€‹
file_type
enum<string>
required

Supported file type

Available options:
pdf,
jpeg,
png
Example:

"pdf"

ā€‹
file_content
string<byte>
required

Base64-encoded file content. Maximum size after decoding is 10MB.

Example:

"JVBERi0xLjQKJeLjz9MKMw=="

ā€‹
country
string
required

ISO 3166-1 alpha-2 country code of the issuing country. Required for identity documents, not required for EDD documents.

Required string length: 2
Example:

"US"

ā€‹
id_number
string

REQUIRED for identity documents (passport, driver's license, residence permit, national ID). The ID number on the document (e.g., passport number, driver's license number, national ID number). Not required for EDD documents like bank statements.

Example:

"AB1234567"

ā€‹
filename
string

Optional original filename. Will be sanitized for safe storage and display.

Maximum string length: 100
Example:

"passport_front.jpg"

ā€‹
valid_until
string<date>

Optional expiration date of the identity document in YYYY-MM-DD format

Example:

"2027-04-20"

Response

Document uploaded successfully

Response after successfully uploading a document

ā€‹
document_id
string
required

KSUID is a 27-character globally unique ID that combines a timestamp with a random component. Used for all entity identifiers in the Dakota platform.

Required string length: 27
Pattern: ^[0-9A-Za-z]{27}$
Example:

"1NFHrqBHb3cTfLVkFSGmHZqdDPi"