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

# Retrieve business transition

> Use this endpoint to retrieve a business transition.

GET/businesstransitions/\{token}

Use this endpoint to retrieve a business transition.

## URL path parameters

| Fields | Description |
| - | - |
| token string  Required | The unique identifier of the business transition you want to retrieve. **Allowable Values:**  Existing business transition token |

## URL query parameters

| Fields | Description |
| - | - |
| fields string  Optional | Field on which to sort. Use any field in the resource model, or one of the system fields `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:**  `createdTime`, `lastModifiedTime`, or any field in the resource model |

## Response body

| Fields | Description |
| - | - |
| business\_token string  Conditionally returned | Unique identifier of the business whose status you want to transition. **Allowable Values:**  Existing business resource token |
| channel string  Returned | Mechanism by which the transaction was initiated. **Allowable Values:**  `API`, `IVR`, `FRAUD`, `ADMIN`, `SYSTEM` |
| created\_time datetime  Conditionally returned | Date and time when the resource was created, in UTC. **Allowable Values:**  datetime **Format:** yyyy-MM-ddThh:mm:ssZ |
| 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 |
| reason string  Conditionally returned | Additional information about the status change. **Allowable Values:**  255 char max |
| 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` |
| status string  Returned | Specifies the status of the business. **Allowable Values:**  `UNVERIFIED`, `LIMITED`, `ACTIVE`, `SUSPENDED`, `CLOSED`, `TERMINATED` |
| token string  Returned | Unique identifier of the business transition. **Allowable Values:**  Existing business transition token |

## Sample response body

```json JSON lines wrap theme={null}
{
  "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 business transitions](https://www.marqeta.com/docs/core-api/business-transitions/list-business-transitions.md)
- [Retrieve deposit account transition](https://www.marqeta.com/docs/core-api/deposit-accounts-v3/account-transitions-v3/retrieve-deposit-account-transition.md)
- [Create business transition](https://www.marqeta.com/docs/core-api/business-transitions/create-business-transition.md)
- [Business Transitions Object](https://www.marqeta.com/docs/core-api/business-transitions/business-transitions-object.md)