{
"id": "<string>",
"status": "KYC",
"user": {
"id": "8E13_EWEF5a9GuatLqwm5eD6kQRFloKKxIkHM14YiIbkrxpfSNft8_-AyiMUmZHkd-zp7qrhiJITsCBlOeJ4db0NOfG5kas5QDcVR1cxU36EGwaxcgB0Qk4xgj-ViS-TMw==",
"first_name": "John",
"last_name": "Doe",
"email": "john@mail.com",
"phone_number": "+14155552671",
"middle_name": "Garrett",
"date_of_birth": {
"day": 1,
"month": 1,
"year": 1980
},
"place_of_birth": {
"city": "San Francisco",
"region": "CA",
"country_iso2": "US"
},
"country_iso2": "US",
"role": "DRIVER",
"loyalty_tier": "GOLD",
"signup_date": "2021-09-01T12:00:00Z"
},
"created_on": "2021-09-01T12:00:00Z",
"updated_on": "2021-09-01T12:00:00Z",
"kyc_url": "https://kyc-provider.example.com/verify?code=8E13_EWEF5a9GuatLqwm5eD6kQRFloKKxIkHM14YiIbkrxpfSNft8",
"tax_profile": {
"organization_name": "Acme Corp.",
"jurisdiction_country_iso2": "US",
"tin": "NL123456789B12",
"no_tin_reason": "<string>",
"citizenships": [
"US"
],
"additional_tax_residencies": [
{
"jurisdiction_country_iso2": "US",
"tin": "NL123456789B12",
"no_tin_reason": "<string>"
}
]
},
"financial_profile": {
"account_purpose": "Business expenses",
"source_of_funds": {
"funds_origin": "Self-employment via online platforms",
"primary_source": "Revenue from self-employment"
}
},
"terms": [
{
"name": "<string>",
"accepted": true,
"accepted_on": "2023-11-07T05:31:56Z"
}
],
"extras": {}
}Application Object
Available operations
| Operation | Method | Endpoint |
|---|---|---|
| Create an application | POST | /application |
| Retreive application information | GET | /application |
Application object
Marqeta-generated application ID.
The status of the application.
It can be used to determine the next steps in the application process.
- "SUBMITTED" The application has been submitted and received.
- "KYC" The application is in KYC (Know Your Customer) status.
- "MANUAL_REVIEW" The application is under manual review.
- "APPROVED" The application has been approved (final state).
- "REJECTED" The application has been rejected (final state).
- "EXPIRED" The application has expired (final state).
Status changes only occur from a previous state to a subsequent state in the list.
For example, an application can transition from SUBMITTED to KYC or
APPROVED.
Once a state is reached, it cannot move back to a previous state.
Not every program produces every status — MANUAL_REVIEW and EXPIRED
in particular depend on the program's KYC workflow and banking partner.
Treat any status in this list as possible, and do not depend on a
specific one being emitted.
For asynchronous flows the initial state is SUBMITTED, and status
changes are delivered to the platform via Application event webhooks.
SUBMITTED, KYC, MANUAL_REVIEW, APPROVED, REJECTED, EXPIRED "KYC"
Information on the user that is applying for an account.
Show child attributes
Show child attributes
"2021-09-01T12:00:00Z"
"2021-09-01T12:00:00Z"
The webview URL for starting the KYC flow with the user. Must be present if status is KYC.
"https://kyc-provider.example.com/verify?code=8E13_EWEF5a9GuatLqwm5eD6kQRFloKKxIkHM14YiIbkrxpfSNft8"
Information about the user's national ID.
Show child attributes
Show child attributes
Information about the user's address. Note that depending on the country, some of the address components may not be available.
Show child attributes
Show child attributes
Information about the user's address. Note that depending on the country, some of the address components may not be available.
Show child attributes
Show child attributes
Information about the user's tax profile.
Show child attributes
Show child attributes
Information about the user's financial profile.
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Information about the user device used to submit the application.
Show child attributes
Show child attributes
Map of additional program-specific information. This is the extension point for attributes that only one program needs. Prefer adding a key here over widening a shared schema or enum. Keys in use for a program are agreed during program onboarding.
Show child attributes
Show child attributes
Was this page helpful?