> ## 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 business transitions

> List all transitions for a given business.

GET/businesstransitions/business/\{business\_token}

List all transitions for a given business.

## URL path parameters

| Fields | Description |
| - | - |
| business\_token string  Required | Unique identifier of the business resource associated with the transitions to retrieve. **Allowable Values:**  Existing business resource token |

## URL query parameters

| Fields | Description |
| - | - |
| count integer  Optional | Number of business transitions to retrieve. **Allowable Values:**  1-10 **Default value:** 5 |
| start\_index integer  Optional | Sort order index of the first resource in the returned array. **Allowable Values:**  Any integer **Default value:** 0 |
| fields string  Optional | Comma-delimited list of fields to return (`field_1,field_2`, and so on). Leave blank to return all fields. **Allowable Values:**  Comma-delimited list of fields, or blank |
| sort\_by string  Optional | Field on which to sort. Use one of the transition fields `token`, `reason`, or `channel`, or one of the system fields `id`, `lastModifiedTime`, or `createdTime`. Prefix the field name with a hyphen (`-`) to sort in descending order. Omit the hyphen to sort in ascending order. **Allowable Values:**  `token`, `reason`, `channel`, `id`, `lastModifiedTime`, `createdTime` **Default value:** `-id` |

## Response body

| Fields | Description |
| - | - |
| count integer  Conditionally returned | The number of resources retrieved. This field is returned if there are resources in your returned array. **Allowable Values:**  1-10 |
| data array of objects  Conditionally returned | Array of business transition objects. Objects are returned as appropriate to your query. **Allowable Values:**  Valid array of one or more business transition objects |
| data\[].**business\_token** string  Conditionally returned | Unique identifier of the business whose status you want to transition. **Allowable Values:**  Existing business resource token |
| data\[].**channel** string  Returned | Mechanism by which the transaction was initiated. **Allowable Values:**  `API`, `IVR`, `FRAUD`, `ADMIN`, `SYSTEM` |
| data\[].**created\_time** datetime  Conditionally returned | Date and time when the resource was created, in UTC. **Allowable Values:**  datetime **Format:** yyyy-MM-ddThh:mm:ssZ |
| data\[].**last\_modified\_time** datetime  Conditionally returned | Date and time when the resource was last updated, in UTC. **Allowable Values:**  datetime **Format:** yyyy-MM-ddThh:mm:ssZ |
| data\[].**reason** string  Conditionally returned | Additional information about the status change. **Allowable Values:**  255 char max |
| data\[].**reason\_code** string  Returned | Identifies the standardized reason for the transition: - **00:** Object activated for the first time - **01:** Requested by you - **02:** Inactivity over time - **03:** This address cannot accept mail or the addressee is unknown - **04:** Negative account balance - **05:** Account under review - **06:** Suspicious activity was identified - **07:** Activity outside the program parameters was identified - **08:** Confirmed fraud was identified - **09:** Matched with an Office of Foreign Assets Control list - **10:** Card was reported lost - **11:** Card information was cloned - **12:** Account or card information was compromised - **13:** Temporary status change while on hold/leave - **14:** Initiated by Marqeta - **15:** Initiated by issuer - **16:** Card expired - **17:** Failed KYC - **18:** Changed to `ACTIVE` because information was properly validated - **19:** Changed to `ACTIVE` because account activity was properly validated - **20:** Change occurred prior to the normalization of reason codes - **21:** Initiated by a third party, often a digital wallet provider - **22:** PIN retry limit reached - **23:** Card was reported stolen - **24:** Address issue - **25:** Name issue - **26:** SSN issue - **27:** DOB issue - **28:** Email issue - **29:** Phone issue - **30:** Account/fulfillment mismatch - **31:** Other reason - **32:** Unblock request - **86:** Notification of death **Allowable Values:**  `00`, `01`, `02`, `03`, `04`, `05`, `06`, `07`, `08`, `09`, `10`, `11`, `12`, `13`, `14`, `15`, `16`, `17`, `18`, `19`, `20`, `21`, `22`, `23`, `24`, `25`, `26`, `27`, `28`, `29`, `30`, `31`, `32`, `86` |
| data\[].**status** string  Returned | Specifies the status of the business. **Allowable Values:**  `UNVERIFIED`, `LIMITED`, `ACTIVE`, `SUSPENDED`, `CLOSED`, `TERMINATED` |
| data\[].**token** string  Returned | Unique identifier of the business transition. **Allowable Values:**  Existing business transition token |
| end\_index integer  Conditionally returned | Sort order index of the last resource in the returned array. This field is returned if there are resources in your returned array. **Allowable Values:**  Any integer |
| is\_more boolean  Conditionally returned | A value of `true` indicates that more unreturned resources exist. A value of `false` indicates that no more unreturned resources exist. This field is returned if there are resources in your returned array. **Allowable Values:**  `true`, `false` |
| start\_index integer  Conditionally returned | Sort order index of the first resource in the returned array. This field is returned if there are resources in your returned array. **Allowable Values:**  Any integer |

## Sample response body

```json JSON lines wrap theme={null}
{
  "count": 1,
  "start_index": 0,
  "end_index": 0,
  "is_more": false,
  "data": [
    {
      "token": "activate_05",
      "business_token": "my_business_01",
      "status": "ACTIVE",
      "reason_code": "00",
      "reason": "Activating business",
      "channel": "API",
      "created_time": "2022-11-23T23:28:39Z"
    }
  ]
}
```


## Related topics

- [Business Transitions Overview](https://www.marqeta.com/docs/core-api/business-transitions.md)
- [List direct deposit transitions](https://www.marqeta.com/docs/core-api/ach-receiving/direct-deposit-transitions/list-direct-deposit-transitions-ach-receiving.md)
- [Create business transition](https://www.marqeta.com/docs/core-api/business-transitions/create-business-transition.md)
- [Retrieve business transition](https://www.marqeta.com/docs/core-api/business-transitions/retrieve-business-transition.md)
- [List account transitions](https://www.marqeta.com/docs/core-api/deposit-accounts-v4/account-transitions-v4/list-account-transitions-v4.md)
