Transition application state - Marqeta Docs

POST////

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

{
  "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: `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: `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

{
  "token": "app_state_transition_token_1111",
  "application_token": "application_token_1111",
  "original_status": "APPROVED",
  "status": "ACCEPTED",
  "created_time": "2019-08-24T14:15:22Z"
}