Skip to main content
GET
Get 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

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"

Response

The cardholder's application.

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.

cardholder_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"

status
enum<string>
required

State of the enrollment review. submitted means screening is in progress, which on the clean path lasts seconds. under_review means a reviewer holds it, request_for_information means a reviewer needs something from you, and approved and declined are terminal.

Available options:
submitted,
under_review,
request_for_information,
approved,
declined
Example:

"approved"

requested_information
Cardholder Requirement · object[]
required

Everything a reviewer is currently waiting on. Empty unless the application is in request_for_information.

Note: the cardholder review pipeline is not yet enabled, so this array is currently always empty. Treat an empty array as "nothing is being requested through this channel", not as proof that a review has completed — read status for that.

Example:
created_at
integer
required

Unix timestamp (seconds). Mirrors the cardholder record while the review pipeline is not yet enabled — there is no separate application record to date yet.

updated_at
integer
required

Unix timestamp (seconds). Mirrors the cardholder record, so it moves on any cardholder change (a contact edit, for example) and is not a reliable signal that the review state changed. Read status for review progress.