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

# Transition application state

> Transition the current state of an application to a new state.

POST/credit/applications/\{token}/transitions

Transition the current state of an application to a new state.

## URL path parameters

| Name | Type | Required? | Description | Allowable Values |
| - | - | - | - | - |
| token | string | Required | Unique identifier of the application whose state you want to transition. | Existing application token |

## Request body

| Name | Type | Required? | Description | Allowable Values |
| - | - | - | - | - |
| token | string | Optional | Main identifier of the resource, also used as the idempotency key on the request. | 36 char max |
| terms\_schedule\_tracking\_token | string | Optional | The tracking token of the Terms Schedule. This is the `tracking_token` returned in the `TERMS_SCHEDULE` object when sending a `GET` request to the `/credit/applications/files` endpoint before the user makes a decision on their approved application. Required if transitioning application state to `ACCEPTED` | 36 char max |
| card\_member\_agreement\_tracking\_token | string | Optional | The tracking token of the Card Member Agreement. This is the `tracking_token` returned in the `CARD_MEMBER_AGREEMENT` object when sending a `GET` request to the `/credit/applications/files` endpoint before the user makes a decision on their approved application. Required if transitioning application state to `ACCEPTED` | 36 char max |
| benefits\_disclosure\_tracking\_token | string | Optional | The tracking token of the Benefits Disclosure. This is the `tracking_token` returned in the `BENEFITS_DISCLOSURE` object when sending a `GET` request to the `/credit/applications/files` endpoint before the user makes a decision on their approved application. Required if transitioning application state to `ACCEPTED` | 36 char max |
| rewards\_disclosure\_post\_terms\_tracking\_token | string | Optional | The tracking token of the Rewards Disclosure Post-terms. This is the `tracking_token` returned in the `REWARDS_DISCLOSURE_POST_TERMS` object when sending a `GET` request to the `/credit/applications/files` endpoint before the user makes a decision on their approved application. Required if transitioning application state to `ACCEPTED` | 36 char max |
| application\_state | string | Required | State of the application. If manually [transitioning an application state](https://www.marqeta.com/docs/core-api/credit-applications/transition-state.md): **`application_state` is the state to which you want to transition the application status; must be `ACCEPTED` or `REJECTED`.**`original_status` returns the state of the application before it was manually transitioned. \* `status` returns the state to which the application was transitioned. | `CREATED`, `DECISIONING`, `MANUAL_REVIEW`, `EXPIRED`, `APPROVED`, `REJECTED`, `ACCEPTED`, `DECLINED`, `ERROR` |

## Sample request body

```json JSON lines wrap theme={null}
{
  "terms_schedule_tracking_token": "tracking_token_CpkwJCoqzucVnJNwj5BsKC9e5",
  "card_member_agreement_tracking_token": "tracking_token_c1YjY2NjBlOGEiLCJzdGF0Z",
  "benefits_disclosure_tracking_token": "tracking_token_JXRapWJL2BI4EwdNqjBBvpI5",
  "rewards_disclosure_post_terms_tracking_token": "tracking_token_ZjNmZ0MzIyNDYsImlhdCI",
  "application_state": "ACCEPTED"
}
```

## Response body

| Name | Type | Required? | Description | Allowable Values |
| - | - | - | - | - |
| token | string | Conditionally returned | Unique identifier of the transition of an application's state. | 36 char max |
| application\_token | string | Conditionally returned | Unique identifier of the application whose state you transitioned. | 36 char max |
| original\_status | string | Conditionally returned | State of the application. If manually [transitioning an application state](https://www.marqeta.com/docs/core-api/credit-applications/transition-state.md): **`application_state` is the state to which you want to transition the application status; must be `ACCEPTED` or `REJECTED`.**`original_status` returns the state of the application before it was manually transitioned. \* `status` returns the state to which the application was transitioned. | `CREATED`, `DECISIONING`, `MANUAL_REVIEW`, `EXPIRED`, `APPROVED`, `REJECTED`, `ACCEPTED`, `DECLINED`, `ERROR` |
| status | string | Conditionally returned | State of the application. If manually [transitioning an application state](https://www.marqeta.com/docs/core-api/credit-applications/transition-state.md): **`application_state` is the state to which you want to transition the application status; must be `ACCEPTED` or `REJECTED`.**`original_status` returns the state of the application before it was manually transitioned. \* `status` returns the state to which the application was transitioned. | `CREATED`, `DECISIONING`, `MANUAL_REVIEW`, `EXPIRED`, `APPROVED`, `REJECTED`, `ACCEPTED`, `DECLINED`, `ERROR` |
| created\_time | datetime | Conditionally returned | Date and time when the application changed states on the Marqeta platform, in UTC. | Format: yyyy-MM-ddThh:mm:ssZ |

## Sample response body

```json JSON lines wrap theme={null}
{
  "token": "app_state_transition_token_1111",
  "application_token": "application_token_1111",
  "original_status": "APPROVED",
  "status": "ACCEPTED",
  "created_time": "2019-08-24T14:15:22Z"
}
```


## Related topics

- [Applications Overview](https://www.marqeta.com/docs/core-api/credit-applications.md)
- [List application transitions](https://www.marqeta.com/docs/core-api/credit-applications/list-application-transitions.md)
- [List delinquency state transitions](https://www.marqeta.com/docs/core-api/credit-account-delinquency/list-state-transitions.md)
- [Retrieve delinquency state transition](https://www.marqeta.com/docs/core-api/credit-account-delinquency/retrieve-state-transition.md)
- [About Disputes](https://www.marqeta.com/docs/developer-guides/about-disputes.md)