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

# Business Transitions

> Use the business transitions endpoints to change, list, and retrieve the states of your business resources.

export const EndpointCard = ({method = "API", title, children, href, arrow = true}) => {
  const METHOD_STYLES = {
    GET: {
      bg: "mint-bg-green-400/20 dark:mint-bg-green-400/20",
      text: "mint-text-green-700 dark:mint-text-green-400",
      border: "mint-border-green-300 dark:mint-border-green-700"
    },
    POST: {
      bg: "mint-bg-blue-400/20 dark:mint-bg-blue-400/20",
      text: "mint-text-blue-700 dark:mint-text-blue-400"
    },
    PUT: {
      bg: "mint-bg-yellow-400/20 dark:mint-bg-yellow-400/20",
      text: "mint-text-yellow-700 dark:mint-text-yellow-400"
    },
    PATCH: {
      bg: "mint-bg-orange-400/20 dark:mint-bg-orange-400/20",
      text: "mint-text-orange-700 dark:mint-text-orange-400"
    },
    DELETE: {
      bg: "mint-bg-red-400/20 dark:mint-bg-red-400/20",
      text: "mint-text-red-700 dark:mint-text-red-400"
    },
    API: {
      bg: "mint-bg-black",
      text: "mint-text-white"
    }
  };
  const MethodBadge = ({method}) => {
    const style = METHOD_STYLES[method?.toUpperCase()] ?? METHOD_STYLES.GET;
    return <span className={`
          method-pill rounded-lg font-semibold px-1.5 py-0.5 text-xs leading-5 ${style.bg} ${style.text}`}>
        {method?.toUpperCase()}
      </span>;
  };
  const content = <div className="group flex items-center gap-4 border border-gray-200 dark:border-gray-700 rounded-xl p-5 hover:border-gray-400 dark:hover:border-gray-500 hover:shadow-md transition-all cursor-pointer">
      {}
      <div className="shrink-0">
        <MethodBadge method={method} />
      </div>
      {}
      <div className="flex-1 min-w-0">
        <p className="font-semibold text-gray-900 dark:text-white text-sm leading-snug">{title}</p>
        {children && <p className="mt-1 text-sm text-gray-500 dark:text-gray-400 line-clamp-2">{children}</p>}
      </div>
    </div>;
  if (!href) return content;
  return <a href={href} className="block no-underline border-b-0 mb-2">
      {content}
    </a>;
};

Use the `/businesstransitions` endpoints to transition business resources between states, as well as to retrieve and list state changes for a business resource.

<h2 id="post_businesstransitions">
  Create business transition
</h2>

**Action:** `POST`\
**Endpoint:** `/businesstransitions`

{/* <EndpointCard
title="Creates a business transition"
path="/businesstransitions"
method="post"
/> */}

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.<br /><br />**The business.active field:**<br />`false`<br /><br />**Allowable Transitions:**<br />`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`.<br /><br />**The business.active field:**<br />`true`<br /><br />**Allowable Transitions:**<br />`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.<br /><br />**The business.active field:**<br />`true`<br /><br />**Allowable Transitions:**<br />`SUSPENDED`, `CLOSED`                                                                     |
| `SUSPENDED`               | The business is temporarily inactive.<br /><br />**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.<br /><br />**The business.active field:**<br />`false`<br /><br />**Allowable Transitions:**<br />`ACTIVE`, `LIMITED`, `UNVERIFIED`, `CLOSED`, `TERMINATED` |
| `CLOSED`                  | The business is permanently inactive.<br /><br />**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.<br /><br />**The business.active field:**<br />`false`<br /><br />**Allowable Transitions:**<br />`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.<br /><br />**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.<br /><br />**Allowable Transitions:**<br />None | Cannot load funds, activate cards, or transact.<br /><br />**The business.active field:**<br />`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.
</Note>

<h3 id="_request_body">
  Request body
</h3>

| Fields                                                | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ----------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| business\_token<br /><br />string<br /><br />Required | Unique identifier of the business whose status you want to transition.<br /><br />**Allowable Values:**<br /><br />Existing business resource token                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| channel<br /><br />string<br /><br />Required         | Mechanism by which the transaction was initiated.<br /><br />**Allowable Values:**<br /><br />`API`, `IVR`, `FRAUD`, `ADMIN`, `SYSTEM`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| idempotentHash<br /><br />string<br /><br />Optional  | Unique hashed value that identifies subsequent submissions of the business transition request.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| reason<br /><br />string<br /><br />Optional          | Additional information about the status change.<br /><br />**Allowable Values:**<br /><br />255 char max                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| reason\_code<br /><br />string<br /><br />Required    | Identifies the standardized reason for the transition:<br /><br />- **00:** Object activated for the first time<br />- **01:** Requested by you<br />- **02:** Inactivity over time<br />- **03:** This address cannot accept mail or the addressee is unknown<br />- **04:** Negative account balance<br />- **05:** Account under review<br />- **06:** Suspicious activity was identified<br />- **07:** Activity outside the program parameters was identified<br />- **08:** Confirmed fraud was identified<br />- **09:** Matched with an Office of Foreign Assets Control list<br />- **10:** Card was reported lost<br />- **11:** Card information was cloned<br />- **12:** Account or card information was compromised<br />- **13:** Temporary status change while on hold/leave<br />- **14:** Initiated by Marqeta<br />- **15:** Initiated by issuer<br />- **16:** Card expired<br />- **17:** Failed KYC<br />- **18:** Changed to `ACTIVE` because information was properly validated<br />- **19:** Changed to `ACTIVE` because account activity was properly validated<br />- **20:** Change occurred prior to the normalization of reason codes<br />- **21:** Initiated by a third party, often a digital wallet provider<br />- **22:** PIN retry limit reached<br />- **23:** Card was reported stolen<br />- **24:** Address issue<br />- **25:** Name issue<br />- **26:** SSN issue<br />- **27:** DOB issue<br />- **28:** Email issue<br />- **29:** Phone issue<br />- **30:** Account/fulfillment mismatch<br />- **31:** Other reason<br />- **32:** Unblock request<br />- **86:** Notification of death<br /><br />**Allowable Values:**<br /><br />`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<br /><br />string<br /><br />Required          | Specifies the new status of the business.<br /><br />**Allowable Values:**<br /><br />`UNVERIFIED`, `LIMITED`, `ACTIVE`, `SUSPENDED`, `CLOSED`, `TERMINATED`                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| token<br /><br />string<br /><br />Optional           | Unique identifier of the business transition.<br /><br />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.<br /><br />**Allowable Values:**<br /><br />36 char max                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |

<h3 id="_sample_request_body">
  Sample request body
</h3>

```json JSON lines wrap theme={null}
{
  "token": "activate_05",
  "business_token": "my_business_01",
  "status": "ACTIVE",
  "reason_code": "00",
  "reason": "Activating business",
  "channel": "API"
}
```

<h3 id="_response_body">
  Response body
</h3>

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

<h3 id="_sample_response_body">
  Sample response body
</h3>

```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"
}
```

<h2 id="get_businesstransitions_business_businesstoken">
  List business transitions
</h2>

**Action:** `GET`\
**Endpoint:** `/businesstransitions/business/{business_token}`

{/* <EndpointCard
title="Returns transitions for a given business"
path="/businesstransitions/business/{business_token}"
method="get"
/> */}

List all transitions for a given business.

<h3 id="_url_path_parameters">
  URL path parameters
</h3>

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

<h3 id="_url_query_parameters">
  URL query parameters
</h3>

| Fields                                              | Description                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| count<br /><br />integer<br /><br />Optional        | Number of business transitions to retrieve.<br /><br />**Allowable Values:**<br /><br />1-10<br /><br />**Default value:**<br />5                                                                                                                                                                                                                                                                           |
| start\_index<br /><br />integer<br /><br />Optional | Sort order index of the first resource in the returned array.<br /><br />**Allowable Values:**<br /><br />Any integer<br /><br />**Default value:**<br />0                                                                                                                                                                                                                                                  |
| fields<br /><br />string<br /><br />Optional        | Comma-delimited list of fields to return (`field_1,field_2`, and so on). Leave blank to return all fields.<br /><br />**Allowable Values:**<br /><br />Comma-delimited list of fields, or blank                                                                                                                                                                                                             |
| sort\_by<br /><br />string<br /><br />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.<br /><br />**Allowable Values:**<br /><br />`createdTime`, `lastModifiedTime`, or any field in the resource model<br /><br />**Default value:**<br />`-id` |

<h3 id="_response_body_2">
  Response body
</h3>

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

<h3 id="_sample_response_body_2">
  Sample response body
</h3>

```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"
    }
  ]
}
```

<h2 id="get_businesstransitions_token">
  Retrieve business transition
</h2>

**Action:** `GET`\
**Endpoint:** `/businesstransitions/{token}`

{/* <EndpointCard
title="Returns a business transition"
path="/businesstransitions/{token}"
method="get"
/> */}

Use this endpoint to retrieve a business transition.

<h3 id="_url_path_parameters_2">
  URL path parameters
</h3>

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

<h3 id="_url_query_parameters_2">
  URL query parameters
</h3>

| Fields                                       | Description                                                                                                                                                                                                                                                                                                                                                        |
| -------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| fields<br /><br />string<br /><br />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.<br /><br />**Allowable Values:**<br /><br />`createdTime`, `lastModifiedTime`, or any field in the resource model |

<h3 id="_response_body_3">
  Response body
</h3>

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

<h3 id="_sample_response_body_3">
  Sample response body
</h3>

```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

- [Businesses](/docs/core-api/businesses.md)
- [Event Types](/docs/core-api/event-types.md)
- [Release Notes](/docs/developer-guides/release-notes-2025.md)
- [2024 Release Notes](/docs/developer-guides/release-notes-2024.md)