> ## Documentation Index > Fetch the complete documentation index at: https://www.marqeta.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create account transition > Creates a new status transition for a deposit account, changing its status to ACTIVE, SUSPENDED, or TERMINATED. POST/depositaccounts/\{account\_token}/transitions Creates a new status transition for a deposit account, changing its status to `ACTIVE`, `SUSPENDED`, or `TERMINATED`. > [!CAUTION] > > 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 JSON lines wrap theme={null} { "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](https://www.swift.com/standards/data-standards/bic-business-identifier-code) | | 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 JSON expandable lines wrap theme={null} { "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" } } ``` ## Related topics - [Retrieve account transition](https://www.marqeta.com/docs/core-api/deposit-accounts-v4/account-transitions-v4/retrieve-account-transition-v4.md) - [Deposit Account Transitions (v4) Overview](https://www.marqeta.com/docs/core-api/deposit-accounts-v4/account-transitions-v4.md) - [Deposit Accounts v4 Overview](https://www.marqeta.com/docs/core-api/deposit-accounts-v4.md) - [Create deposit account transition](https://www.marqeta.com/docs/core-api/deposit-accounts-v3/account-transitions-v3/create-deposit-account-transition.md) - [Create user transition](https://www.marqeta.com/docs/core-api/user-transitions/create-user-transition.md)