Skip to main content
POST
Submit requested information for a cardholder's application
Sandbox only. This endpoint is available in sandbox only while we finish development. It is not available in production yet, and its request and response shapes may change before release.

Authorizations

x-api-key
string
header
required

Headers

x-idempotency-key
string<uuid>
required

Unique key to ensure request idempotency. If the same key is used within a certain time window, the original response will be returned instead of executing the request again.

Path Parameters

cardholder_id
string
required

The cardholder's ID. 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

Answers to open request items on a cardholder's application.

responses
Cardholder Information Response · object[]
required

One entry per request item being answered. A request_id may appear at most once.

Required array length: 1 - 50 elements

Response

The submission was accepted. The body carries the application as GET /cardholders/{cardholder_id}/application now returns it, plus an upload target for every document item answered.

The application after a submission, with any upload targets it produced.

application
Cardholder Application Response · object
required

The enrollment application behind a cardholder: its review state and anything a reviewer is currently waiting on.

The application status is narrower than the cardholder status — it describes only the review outcome, so it never carries lifecycle states like suspended or closed.

A suspended cardholder reads submitted, not approved: a cardholder may be suspended while still mid-onboarding, so suspension is not evidence that the enrollment was ever approved. Treat submitted there as "no decision is being asserted" rather than as proof the review is still running.

upload_targets
Cardholder Document Upload Target · object[]

One target per document item answered. Omitted until document uploads are served; once they are, empty means none were answered.