This feature is currently in beta and subject to change.
To learn more about the Beta program for this feature, contact your Marqeta Customer Success representative.
status of PENDING while it is being provisioned at the financial institution.
Once provisioning is complete, the status transitions to ACTIVE and the account becomes available for use.
The v4 API supports end-user interest-bearing accounts, which is a separate feature currently in beta.
To learn more about the Beta program for this feature, contact your Marqeta Customer Success representative.
Create deposit account
Action:POST
Endpoint: /depositaccounts
Creates a new deposit account for a user or business.
Supports account types including CHECKING, SAVINGS, WALLET, and DEPOSIT_ACCOUNT.
Request body
| Fields | Description |
|---|---|
| user_token string Optional | Unique identifier of the user for whom to create the deposit account. Required if business_token is not provided.Allowable Values: 36 char max |
| business_token string Optional | Unique identifier of the business for which to create the deposit account. Required if user_token is not provided.Allowable Values: 36 char max |
| name string Required | Label used to identify the account. The combination of name and type must be unique per user or business; you cannot create multiple accounts of the same type with the same name. Allowable Values: 255 char max |
| type string Required | Type of deposit account to create. The combination of name and type must be unique per user or business; you cannot create multiple accounts of the same type with the same name. Allowable Values: CHECKING, SAVINGS, WALLET, DEPOSIT_ACCOUNT |
| customer_due_diligence array of objects Optional | Array containing customer due diligence (CDD) data associated with the account holder. Required if the type field is set to CHECKING.Allowable Values: Array of customer_due_diligence objects |
| customer_due_diligence[].question string Required | Token that identifies the customer due diligence (CDD) question being asked. Allowable Values: Example: dda_002_cdd_01_expmondep |
| customer_due_diligence[].answer string Required | Value of the answer to the customer due diligence question, written as a number. Allowable Values: Example: 2 |
| customer_due_diligence[].token string Optional | Unique identifier of the CDD entry. If you do not include a token, the system will generate one automatically. Allowable Values: 36 char max |
Sample request body
Create a checking account for a userJSON
{
"user_token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"name": "My Checking Account",
"type": "CHECKING",
"customer_due_diligence": [
{
"question": "dda_002_cdd_01_expmondep",
"answer": "2"
}
]
}
JSON
{
"business_token": "d4e5f678-90ab-cdef-1234-567890abcdef",
"name": "Business Savings Account",
"type": "SAVINGS"
}
Response body
| Fields | Description |
|---|---|
| token string Returned | Unique identifier of the deposit account. Allowable Values: 36 char max |
| name string Conditionally returned | Name of the deposit account. Allowable Values: 255 char max |
| user_token string Conditionally returned | Unique identifier of the user associated with the deposit account. Allowable Values: 36 char max |
| business_token string Conditionally returned | Unique identifier of the business associated with the deposit account. Allowable Values: 36 char max |
| status string Returned | Current status of the deposit account. Allowable Values: ACTIVE, SUSPENDED, TERMINATED, PENDING, FAILED |
| type string Conditionally returned | Type of the deposit account. Allowable Values: CHECKING, SAVINGS, WALLET, DEPOSIT_ACCOUNT |
| created_time datetime Returned | Date and time when the deposit account was created, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| last_modified_time datetime Returned | Date and time when the deposit account was last updated, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
Pending user checking accountJSON
{
"token": "b27f2c40-3a2e-4d8f-a93b-7c6e1f5d8b21",
"name": "My Checking Account",
"user_token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "PENDING",
"type": "CHECKING",
"created_time": "2026-01-08T17:56:06Z",
"last_modified_time": "2026-01-08T17:56:06Z"
}
JSON
{
"token": "c38a3d51-4b3f-5e9a-b04c-8d7a70c9d321",
"name": "Business Savings Account",
"business_token": "d4e5f678-90ab-cdef-1234-567890abcdef",
"status": "PENDING",
"type": "SAVINGS",
"created_time": "2026-01-08T17:56:06Z",
"last_modified_time": "2026-01-08T17:56:06Z"
}
Retrieve deposit account
Action:GET
Endpoint: /depositaccounts/{account_token}
Retrieves a deposit account using the specified account token.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the deposit account, as returned by the POST /depositaccounts endpoint.Allowable Values: Existing deposit account token |
Response body
| Fields | Description |
|---|---|
| token string Returned | Unique identifier of the deposit account. Allowable Values: 36 char max |
| name string Conditionally returned | Name of the deposit account. Allowable Values: 255 char max |
| user_token string Conditionally returned | Unique identifier of the user associated with the deposit account. Allowable Values: 36 char max |
| business_token string Conditionally returned | Unique identifier of the business associated with the deposit account. Allowable Values: 36 char max |
| status string Returned | Current status of the deposit account. Allowable Values: ACTIVE, SUSPENDED, TERMINATED, PENDING, FAILED |
| reason string Conditionally returned | Explanation of the current status of the deposit account. Allowable Values: 255 char max |
| type string Conditionally returned | Type of the deposit account. Allowable Values: CHECKING, SAVINGS, WALLET, DEPOSIT_ACCOUNT |
| account_number string Conditionally returned | Bank account number associated with the deposit account. Allowable Values: A valid bank account number |
| routing_number string Conditionally returned | Bank routing number used for US automated clearing house (ACH) transactions, or a local clearing code for other regions. Allowable Values: A valid bank routing number |
| sort_code string Conditionally returned | Sort code that identifies the bank and branch, primarily used in the United Kingdom. Allowable Values: 6 digit code |
| ibans array of strings Conditionally returned | Array of International Bank Account Numbers (IBANs) for cross-border transfers. Allowable Values: Up to 34 char max per IBAN, depending on the country |
| bic string Conditionally returned | Bank Identifier Code used for international identification of banks. Allowable Values: 8 char max. See the SWIFT BIC standard |
| interest_tier_token string Conditionally returned | Unique identifier of the interest tier applied to the deposit account. Allowable Values: 36 char max |
| current_tier_rate string Conditionally returned | Current interest rate applied to the deposit account, as a percentage ranging from 0 to 100. Do not include a percent sign (%). Allowable Values: 0–100 |
| created_time datetime Returned | Date and time when the deposit account was created, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| last_modified_time datetime Returned | Date and time when the deposit account was last updated, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
{
"token": "b27f2c40-3a2e-4d8f-a93b-7c6e1f5d8b21",
"name": "My Checking Account",
"user_token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "ACTIVE",
"type": "CHECKING",
"account_number": "9873654102",
"routing_number": "021000021",
"created_time": "2026-01-08T17:56:06Z",
"last_modified_time": "2026-01-08T17:56:06Z"
}
List deposit accounts for a user
Action:GET
Endpoint: /depositaccounts/user/{user_token}
Returns a paginated list of deposit accounts associated with the specified user.
URL path parameters
| Fields | Description |
|---|---|
| user_token string Required | Unique identifier of the user associated with the deposit accounts to retrieve. Allowable Values: 36 char max |
URL query parameters
| Fields | Description |
|---|---|
| count integer Optional | Number of deposit accounts to retrieve. Allowable Values: Any integer |
| start_index integer Optional | Index of the first result in the returned array. Use for pagination. Allowable Values: Any integer |
| sort_by string Optional | Field on which to sort. Prefix with - for descending order.Allowable Values: createdTime, lastModifiedTime, or any field in the resource model |
| status string Optional | Status of the deposit accounts to retrieve. Allowable Values: ACTIVE, SUSPENDED, TERMINATED, PENDING, FAILED |
Response body
| Fields | Description |
|---|---|
| count integer Conditionally returned | Number of deposit account resources returned. Allowable Values: Any integer |
| data array of objects Conditionally returned | Array of deposit account objects. Allowable Values: Valid array of one or more deposit account objects |
| data[].token string Returned | Unique identifier of the deposit account. Allowable Values: 36 char max |
| data[].name string Conditionally returned | Name of the deposit account. Allowable Values: 255 char max |
| data[].user_token string Conditionally returned | Unique identifier of the user associated with the deposit account. Allowable Values: 36 char max |
| data[].business_token string Conditionally returned | Unique identifier of the business associated with the deposit account. Allowable Values: 36 char max |
| data[].status string Returned | Current status of the deposit account. Allowable Values: ACTIVE, SUSPENDED, TERMINATED, PENDING, FAILED |
| data[].reason string Conditionally returned | Explanation of the current status of the deposit account. Allowable Values: 255 char max |
| data[].type string Conditionally returned | Type of the deposit account. Allowable Values: CHECKING, SAVINGS, WALLET, DEPOSIT_ACCOUNT |
| data[].account_number string Conditionally returned | Bank account number associated with the deposit account. Allowable Values: A valid bank account number |
| data[].routing_number string Conditionally returned | Bank routing number used for US automated clearing house (ACH) transactions, or a local clearing code for other regions. Allowable Values: A valid bank routing number |
| data[].sort_code string Conditionally returned | Sort code that identifies the bank and branch, primarily used in the United Kingdom. Allowable Values: 6 digit code |
| data[].ibans array of strings Conditionally returned | Array of International Bank Account Numbers (IBANs) for cross-border transfers. Allowable Values: Up to 34 char max per IBAN, depending on the country |
| data[].bic string Conditionally returned | Bank Identifier Code used for international identification of banks. Allowable Values: 8 char max. See the SWIFT BIC standard |
| data[].interest_tier_token string Conditionally returned | Unique identifier of the interest tier applied to the deposit account. Allowable Values: 36 char max |
| data[].current_tier_rate string Conditionally returned | Current interest rate applied to the deposit account, as a percentage ranging from 0 to 100. Do not include a percent sign (%). Allowable Values: 0–100 |
| data[].created_time datetime Returned | Date and time when the deposit account was created, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| data[].last_modified_time datetime Returned | Date and time when the deposit account was last updated, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| start_index integer Conditionally returned | Sort order index of the first resource in the returned array. Allowable Values: Any integer |
| end_index integer Conditionally returned | Sort order index of the last resource in the returned array. Allowable Values: Any integer |
| is_more boolean Conditionally returned | A value of true indicates that more unreturned resources exist.Allowable Values: true, false |
Sample response body
JSON
{
"count": 2,
"start_index": 0,
"end_index": 1,
"is_more": false,
"data": [
{
"token": "b27f2c40-3a2e-4d8f-a93b-7c6e1f5d8b21",
"name": "My Checking Account",
"user_token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "ACTIVE",
"type": "CHECKING",
"account_number": "9873654102",
"routing_number": "021000021",
"created_time": "2026-01-08T17:56:06Z",
"last_modified_time": "2026-01-08T17:56:06Z"
},
{
"token": "c38a3d51-4b3f-5e9a-b04c-8d7a70c9d321",
"name": "My Savings Account",
"user_token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "ACTIVE",
"type": "SAVINGS",
"account_number": "8762543091",
"routing_number": "021000021",
"created_time": "2026-01-06T09:20:00Z",
"last_modified_time": "2026-01-06T09:20:00Z"
}
]
}
Create account transition
Action:POST
Endpoint: /depositaccounts/{account_token}/transitions
Creates a new status transition for a deposit account, changing its status to ACTIVE, SUSPENDED, or TERMINATED.
Accounts in the
TERMINATED state cannot be transitioned to another state.
TERMINATED is a final state.URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the deposit account, as returned by the POST /depositaccounts endpoint.Allowable Values: Existing deposit account token |
Request body
| Fields | Description |
|---|---|
| token string Optional | Unique identifier of the transition. If you do not include a token, the system will generate one automatically. Allowable Values: 36 char max |
| status string Required | New status to apply to the deposit account. Allowable Values: ACTIVE, SUSPENDED, TERMINATED |
| reason string Required | Reason for the deposit account status transition. Allowable Values: 1-255 char max |
Sample request body
JSON
{
"token": "e3942f4d-55fc-49dc-b094-d8fc69b8ca38",
"status": "SUSPENDED",
"reason": "Account suspended due to suspicious activity."
}
Response body
| Fields | Description |
|---|---|
| token string Returned | Unique identifier of the deposit account transition. Allowable Values: 36 char max |
| status string Returned | Status of the deposit account at the time of the transition. Allowable Values: ACTIVE, SUSPENDED, TERMINATED |
| reason string Returned | Reason for the deposit account status transition. Allowable Values: 255 char max |
| created_time datetime Returned | Date and time when the transition was created, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| account object Returned | Deposit account associated with the transition. Allowable Values: token, name, user_token, business_token, status, reason, type, account_number, routing_number, sort_code, ibans, bic, interest_tier_token, current_tier_rate, created_time, last_modified_time |
| account.token string Returned | Unique identifier of the deposit account. Allowable Values: 36 char max |
| account.name string Conditionally returned | Name of the deposit account. Allowable Values: 255 char max |
| account.user_token string Conditionally returned | Unique identifier of the user associated with the deposit account. Allowable Values: 36 char max |
| account.business_token string Conditionally returned | Unique identifier of the business associated with the deposit account. Allowable Values: 36 char max |
| account.status string Returned | Current status of the deposit account. Allowable Values: ACTIVE, SUSPENDED, TERMINATED, PENDING, FAILED |
| account.reason string Conditionally returned | Reason for the current status of the deposit account. Allowable Values: 255 char max |
| account.type string Conditionally returned | Type of the deposit account. Allowable Values: CHECKING, SAVINGS, WALLET, DEPOSIT_ACCOUNT |
| account.account_number string Conditionally returned | Bank account number associated with the deposit account. Allowable Values: A valid bank account number |
| account.routing_number string Conditionally returned | Bank routing number used for US automated clearing house (ACH) transactions, or a local clearing code for other regions. Allowable Values: A valid bank routing number |
| account.sort_code string Conditionally returned | Sort code that identifies the bank and branch, primarily used in the United Kingdom. Allowable Values: 6 digit code |
| account.ibans array of strings Conditionally returned | Array of International Bank Account Numbers (IBANs) for cross-border transfers. Allowable Values: Up to 34 char max per IBAN, depending on the country |
| account.bic string Conditionally returned | Bank Identifier Code used for international identification of banks. Allowable Values: 8 char max. See the SWIFT BIC standard |
| account.interest_tier_token string Conditionally returned | Unique identifier of the interest tier applied to the deposit account. Allowable Values: 36 char max |
| account.current_tier_rate string Conditionally returned | Current interest rate applied to the deposit account, as a percentage ranging from 0 to 100. Do not include a percent sign (%). Allowable Values: 0–100 |
| account.created_time datetime Returned | Date and time when the deposit account was created, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| account.last_modified_time datetime Returned | Date and time when the deposit account was last updated, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
{
"token": "e3942f4d-55fc-49dc-b094-d8fc69b8ca38",
"reason": "Account suspended due to suspicious activity.",
"status": "SUSPENDED",
"created_time": "2026-01-08T18:10:00Z",
"account": {
"token": "b27f2c40-3a2e-4d8f-a93b-7c6e1f5d8b21",
"name": "My Checking Account",
"user_token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "SUSPENDED",
"type": "CHECKING",
"account_number": "9873654102",
"routing_number": "021000021",
"created_time": "2026-01-08T17:56:06Z",
"last_modified_time": "2026-01-08T18:10:00Z"
}
}
List account transitions
Action:GET
Endpoint: /depositaccounts/{account_token}/transitions
Returns a paginated list of status transitions for a specific deposit account.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the deposit account, as returned by the POST /depositaccounts endpoint.Allowable Values: Existing deposit account token |
URL query parameters
| Fields | Description |
|---|---|
| count integer Optional | Number of transitions to retrieve. Allowable Values: Any integer |
| start_index integer Optional | Index of the first result in the returned array. Use for pagination. Allowable Values: Any integer |
| sort_by string Optional | Field on which to sort. Prefix with - for descending order.Allowable Values: createdTime, lastModifiedTime, or any field in the resource model |
Response body
| Fields | Description |
|---|---|
| count integer Conditionally returned | Number of deposit account transition resources returned. Allowable Values: Any integer |
| data array of objects Conditionally returned | Array of deposit account transition objects. Allowable Values: Valid array of one or more account transition objects |
| data[].token string Returned | Unique identifier of the deposit account transition. Allowable Values: 36 char max |
| data[].status string Returned | Status of the deposit account at the time of the transition. Allowable Values: ACTIVE, SUSPENDED, TERMINATED |
| data[].reason string Returned | Reason for the deposit account status transition. Allowable Values: 255 char max |
| data[].created_time datetime Returned | Date and time when the transition was created, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| data[].account object Returned | Deposit account associated with the transition. Allowable Values: token, name, user_token, business_token, status, reason, type, account_number, routing_number, sort_code, ibans, bic, interest_tier_token, current_tier_rate, created_time, last_modified_time |
| data[].account.token string Returned | Unique identifier of the deposit account. Allowable Values: 36 char max |
| data[].account.name string Conditionally returned | Name of the deposit account. Allowable Values: 255 char max |
| data[].account.user_token string Conditionally returned | Unique identifier of the user associated with the deposit account. Allowable Values: 36 char max |
| data[].account.business_token string Conditionally returned | Unique identifier of the business associated with the deposit account. Allowable Values: 36 char max |
| data[].account.status string Returned | Current status of the deposit account. Allowable Values: ACTIVE, SUSPENDED, TERMINATED, PENDING, FAILED |
| data[].account.reason string Conditionally returned | Reason for the current status of the deposit account. Allowable Values: 255 char max |
| data[].account.type string Conditionally returned | Type of the deposit account. Allowable Values: CHECKING, SAVINGS, WALLET, DEPOSIT_ACCOUNT |
| data[].account.account_number string Conditionally returned | Bank account number associated with the deposit account. Allowable Values: A valid bank account number |
| data[].account.routing_number string Conditionally returned | Bank routing number used for US automated clearing house (ACH) transactions, or a local clearing code for other regions. Allowable Values: A valid bank routing number |
| data[].account.sort_code string Conditionally returned | Sort code that identifies the bank and branch, primarily used in the United Kingdom. Allowable Values: 6 digit code |
| data[].account.ibans array of strings Conditionally returned | Array of International Bank Account Numbers (IBANs) for cross-border transfers. Allowable Values: Up to 34 char max per IBAN, depending on the country |
| data[].account.bic string Conditionally returned | Bank Identifier Code used for international identification of banks. Allowable Values: 8 char max. See the SWIFT BIC standard |
| data[].account.interest_tier_token string Conditionally returned | Unique identifier of the interest tier applied to the deposit account. Allowable Values: 36 char max |
| data[].account.current_tier_rate string Conditionally returned | Current interest rate applied to the deposit account, as a percentage ranging from 0 to 100. Do not include a percent sign (%). Allowable Values: 0–100 |
| data[].account.created_time datetime Returned | Date and time when the deposit account was created, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| data[].account.last_modified_time datetime Returned | Date and time when the deposit account was last updated, in UTC. Allowable Values: datetime Format: yyyy-MM-ddThh:mm:ssZ |
| end_index integer Conditionally returned | Sort order index of the last resource in the returned array. Allowable Values: Any integer |
| is_more boolean Conditionally returned | A value of true indicates that more unreturned resources exist.Allowable Values: true, false |
| start_index integer Conditionally returned | Sort order index of the first resource in the returned array. Allowable Values: Any integer |
Sample response body
JSON
{
"count": 1,
"start_index": 0,
"end_index": 0,
"is_more": false,
"data": [
{
"token": "e3942f4d-55fc-49dc-b094-d8fc69b8ca38",
"reason": "Account suspended due to suspicious activity.",
"status": "SUSPENDED",
"created_time": "2026-01-08T18:10:00Z",
"account": {
"token": "b27f2c40-3a2e-4d8f-a93b-7c6e1f5d8b21",
"name": "My Checking Account",
"user_token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "SUSPENDED",
"type": "CHECKING",
"account_number": "9873654102",
"routing_number": "021000021",
"created_time": "2026-01-08T17:56:06Z",
"last_modified_time": "2026-01-08T18:10:00Z"
}
}
]
}
Retrieve account transition
Action:GET
Endpoint: /depositaccounts/{account_token}/transitions/{transition_token}
Retrieves a specific status transition for a deposit account using the provided transition token.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the deposit account, as returned by the POST /depositaccounts endpoint.Allowable Values: Existing deposit account token |
| transition_token string Required | Unique identifier of the account transition, as returned by the POST /depositaccounts/{account_token}/transitions endpoint.Allowable Values: 36 char max |
Response body
The response body contains the same fields as Create account transition.Sample response body
JSON
{
"token": "e3942f4d-55fc-49dc-b094-d8fc69b8ca38",
"reason": "Account suspended due to suspicious activity.",
"status": "SUSPENDED",
"created_time": "2026-01-08T18:10:00Z",
"account": {
"token": "b27f2c40-3a2e-4d8f-a93b-7c6e1f5d8b21",
"name": "My Checking Account",
"user_token": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": "SUSPENDED",
"type": "CHECKING",
"account_number": "9873654102",
"routing_number": "021000021",
"created_time": "2026-01-08T17:56:06Z",
"last_modified_time": "2026-01-08T18:10:00Z"
}
}
Retrieve CDD information
Action:GET
Endpoint: /depositaccounts/{account_token}/cdd
Retrieves customer due diligence (CDD) information for a specific deposit account.
For more information on CDD, see About Customer Due Diligence.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the deposit account, as returned by the POST /depositaccounts endpoint.Allowable Values: Existing deposit account token |
Response body
| Fields | Description |
|---|---|
| data array of objects Conditionally returned | Array containing a CDD entry for each due diligence question and answer associated with the specified account. Allowable Values: Valid array of one or more customer due diligence objects |
| data[].token string Returned | Unique identifier of the CDD entry. Allowable Values: 36 char max |
| data[].account_token string Returned | Unique identifier of the deposit account associated with this CDD entry. Allowable Values: 36 char max |
| data[].question string Returned | Token that identifies the CDD question that was answered. Allowable Values: Example: dda_002_cdd_01_expmondep |
| data[].answer string Returned | Value of the answer provided for the customer due diligence question, presented as a number. Allowable Values: Example: 2 |
| data[].bank string Returned | Name of the bank associated with this CDD entry. Allowable Values: 255 char max Example: First Demo Bank |
| data[].type string Returned | Type of deposit account associated with this CDD entry. Allowable Values: CHECKING |
Sample response body
JSON
{
"data": [
{
"token": "e691a7ae-f9ae-4184-a2e9-cf6bbc963e4a",
"account_token": "1bb17a10-8d12-442b-95c0-1babd9a78f92",
"question": "dda_002_cdd_01_expmondep",
"answer": "2",
"bank": "Bank Name",
"type": "CHECKING"
},
{
"token": "e509fb2f-f55f-48de-a226-5456c6c78dd4",
"account_token": "1bb17a10-8d12-442b-95c0-1babd9a78f92",
"question": "dda_002_cdd_02_naics",
"answer": "6241",
"bank": "First Demo Bank",
"type": "CHECKING"
}
]
}
Update CDD answers
Action:PUT
Endpoint: /depositaccounts/{account_token}/cdd/{cdd_token}
Updates customer due diligence (CDD) answers for a specific deposit account.
Each CDD question must be updated separately.
You cannot update multiple questions in a single request.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the deposit account, as returned by the POST /depositaccounts endpoint.Allowable Values: Existing deposit account token |
| cdd_token string Required | Unique identifier of the CDD entry. Allowable Values: Existing CDD token |
Request body
| Fields | Description |
|---|---|
| answer string Required | Value of the updated answer to the customer due diligence (CDD) question, written as a number. Allowable Values: Example: 4 |
Sample request body
JSON
{
"answer": "4"
}
Response body
| Fields | Description |
|---|---|
| token string Returned | Unique identifier of the CDD entry. Allowable Values: 36 char max |
| account_token string Returned | Unique identifier of the deposit account associated with this CDD entry. Allowable Values: 36 char max |
| question string Returned | Token that identifies the CDD question that was answered. Allowable Values: Example: dda_002_cdd_01_expmondep |
| answer string Returned | Value of the updated answer provided for the customer due diligence question, written as a number. Allowable Values: Example: 4 |
| bank string Returned | Name of the bank associated with this CDD entry. Allowable Values: 255 char max Example: First Demo Bank |
| type string Returned | Type of deposit account associated with this CDD entry. Allowable Values: CHECKING |
Sample response body
JSON
{
"question": "dda_002_cdd_01_expmondep",
"answer": "4",
"type": "CHECKING",
"bank": "First Demo Bank",
"token": "e691a7ae-f9ae-4184-a2e9-cf6bbc963e4a",
"account_token": "1bb17a10-8d12-442b-95c0-1babd9a78f92"
}