> ## 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.

# List account transitions

> Returns a paginated list of status transitions for a specific deposit account.

GET/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](https://www.swift.com/standards/data-standards/bic-business-identifier-code) |
| 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 JSON expandable lines wrap theme={null}
{
  "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"
      }
    }
  ]
}
```


## Related topics

- [List account transitions](https://www.marqeta.com/docs/core-api/credit-account-transitions/list-account-transitions-transitions.md)
- [Account Transitions Overview](https://www.marqeta.com/docs/core-api/credit-account-transitions.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)
- [List business transitions](https://www.marqeta.com/docs/core-api/business-transitions/list-business-transitions.md)