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

> This endpoint enables you to change a business' status, depending on your role and the previous status change.

POST/businesstransitions

This endpoint enables you to change a business' status, depending on your role and the previous status change. By changing a business' status, you can control the business' capabilities and the setting of the `business.active` field. The `business.active` field is `true` if your business is in the `LIMITED` or `ACTIVE` state, and `false` if your business is in the `UNVERIFIED` state. You cannot control the value of the `business.active` field directly.

| The business.status Field | Description | Business Limitations |
| - | - | - |
| `UNVERIFIED` | Initial status of a newly created business belonging to an `accountholdergroup` where KYC is always required. | Cannot load funds. **The business.active field:** `false` **Allowable Transitions:** `ACTIVE`, `SUSPENDED`, `CLOSED`, `TERMINATED` |
| `LIMITED` | Initial status of a newly created business belonging to an `accountholdergroup` where KYC is conditionally required. | Restricted by rules in `accountholdergroups.pre_kyc_controls`. **The business.active field:** `true` **Allowable Transitions:** `ACTIVE`, `SUSPENDED`, `CLOSED` |
| `ACTIVE` | Status of a business that has passed KYC; initial status of a newly created business belonging to an `accountholdergroup` where KYC is never required. | None. **The business.active field:** `true` **Allowable Transitions:** `SUSPENDED`, `CLOSED` |
| `SUSPENDED` | The business is temporarily inactive. **NOTE:** Transitioning a suspended business to the `ACTIVE` status is restricted, based on your role and the details of the previous status change. | Cannot load funds or activate cards. **The business.active field:** `false` **Allowable Transitions:** `ACTIVE`, `LIMITED`, `UNVERIFIED`, `CLOSED`, `TERMINATED` |
| `CLOSED` | The business is permanently inactive. **NOTE:**`CLOSED` is a terminal status. In exceptional cases, you can transition a business from `CLOSED` to another status, depending on your role and the details of the previous status change. Contact your Marqeta representative for more information. | Cannot load funds. **The business.active field:** `false` **Allowable Transitions:** `ACTIVE`, `LIMITED`, `UNVERIFIED`, `SUSPENDED`, `TERMINATED` |
| `TERMINATED` | The business account is permanently closed. Use the `TERMINATED` state to comply with regulatory requirements, such as the requirement that a business account be irreversibly closed when it does not pass Know Your Business (KYB) verification. **NOTE:**`TERMINATED` is a terminal status. You must have the Admin or Program Manager role to transition a business to the `TERMINATED` state. You cannot transition a business from `TERMINATED` to any other state. Contact your Marqeta representative for more information. **Allowable Transitions:** None | Cannot load funds, activate cards, or transact. **The business.active field:** `false` |

> [!NOTE]
>
> **Note**\
> The Marqeta platform transitions a business's status in response to certain events. For example, a business with an `UNVERIFIED` status transitions to `ACTIVE` when the business passes KYC.

## Request body

| Fields | Description |
| - | - |
| business\_token string  Required | Unique identifier of the business whose status you want to transition. **Allowable Values:**  Existing business resource token |
| channel string  Required | Mechanism by which the transaction was initiated. **Allowable Values:**  `API`, `IVR`, `FRAUD`, `ADMIN`, `SYSTEM` |
| idempotentHash string  Optional | Unique hashed value that identifies subsequent submissions of the business transition request. **Allowable Values:**  255 char max |
| reason string  Optional | Additional information about the status change. **Allowable Values:**  255 char max |
| reason\_code string  Required | 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  Required | Specifies the new status of the business. **Allowable Values:**  `UNVERIFIED`, `LIMITED`, `ACTIVE`, `SUSPENDED`, `CLOSED`, `TERMINATED` |
| token string  Optional | Unique identifier of the business transition. If you do not include a token, the system generates one automatically. This token is referenced in other API calls, so we recommend that you define a simple string that is easy to remember. This value cannot be updated. **Allowable Values:**  36 char max |

## Sample request 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"
}
```

## 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-09-23T23:28:39Z"
}
```


## Related topics

- [Create business](https://www.marqeta.com/docs/core-api/businesses/create-business.md)
- [Business Transitions Overview](https://www.marqeta.com/docs/core-api/business-transitions.md)
- [Create dispute case transition](https://www.marqeta.com/docs/core-api/disputes-visa/dispute-case-transitions-visa/create-dispute-case-transition-visa.md)
- [Create deposit account transition](https://www.marqeta.com/docs/core-api/deposit-accounts-v3/account-transitions-v3/create-deposit-account-transition.md)
- [Create account transition](https://www.marqeta.com/docs/core-api/deposit-accounts-v4/account-transitions-v4/create-account-transition.md)