Account Transitions
Use the account transitions endpoints to create and retrieve account transitions on Marqeta’s credit platform. An account transition occurs when a credit account transitions to a new status.
To receive webhook notifications when account transition events occur, see Credit account transition events in Event Types.
Transition account status
Copy section link
Action: POST
Endpoint: /credit/accounts/{account_token}/accounttransitions
Transition a credit account to a new status.
URL path parameters
Copy section link
| Fields | Description |
|---|---|
account_token
string
|
The unique identifier of the credit account for which to transition a status. Send a Allowable Values: Existing account token |
Request body
Copy section link
| Fields | Description |
|---|---|
status
string
|
Status of the credit account. NOTE Allowable Values:
|
token
string
|
Unique identifier of the credit account transition. Allowable Values: 36 char max |
Response body
Copy section link
| Fields | Description |
|---|---|
token
string
|
Unique identifier of the credit account transition. Allowable Values: 36 char max |
account_token
string
|
Unique identifier of the credit account for which to transition a status. Allowable Values: 36 char max |
original_status
string
|
Status of the credit account prior to transition. Allowable Values:
|
status
string
|
Status to which the credit account transitioned. Allowable Values:
|
created_time
datetime
|
Date and time when the transition record was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
List account transitions
Copy section link
Action: GET
Endpoint: /credit/accounts/{account_token}/accounttransitions
Retrieve an array of transitions on a credit account.
This endpoint supports sorting and pagination.
URL path parameters
Copy section link
| Fields | Description |
|---|---|
account_token
string
|
The unique identifier of the credit account for which you want to retrieve transitions. Send a Allowable Values: Existing account token |
URL query parameters
Copy section link
| Fields | Description |
|---|---|
count
integer
|
The number of resources to retrieve. Allowable Values: 1–100 |
start_index
integer
|
Sort order index of the first resource in the returned array. Allowable Values: 0 min |
sort_by
string
|
Field on which to sort.
Prefix the field name with a hyphen ( NOTE:
You must sort using system field names such as Allowable Values:
|
Response body
Copy section link
| Fields | Description |
|---|---|
count
integer
|
Number of resources returned. Allowable Values: 1-10 |
start_index
integer
|
Sort order index of the first resource in the returned array. Allowable Values: Any integer |
end_index
integer
|
Sort order index of the last resource in the returned array. Allowable Values: Any integer |
is_more
boolean
|
A value of Allowable Values:
|
data
array of objects
|
Contains one or more account transitions. Allowable Values: One or more account transition objects |
data[].token
string
|
Unique identifier of the credit account transition. Allowable Values: 36 char max |
data[].account_token
string
|
Unique identifier of the credit account for which to transition a status. Allowable Values: 36 char max |
data[].original_status
string
|
Status of the credit account prior to transition. Allowable Values:
|
data[].status
string
|
Status to which the credit account transitioned. Allowable Values:
|
data[].created_time
datetime
|
Date and time when the transition record was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Retrieve account transition
Copy section link
Action: GET
Endpoint: /credit/accounts/{account_token}/accounttransitions/{token}
Retrieve a transition for a credit account.
URL path parameters
Copy section link
| Fields | Description |
|---|---|
account_token
string
|
The unique identifier of the credit account for which you want to retrieve a transition. Send a Allowable Values: Existing account token |
token
string
|
The unique identifier of the account transition you want to retrieve. Send a Allowable Values: Existing account transition token |
Response body
Copy section link
| Fields | Description |
|---|---|
token
string
|
Unique identifier of the credit account transition. Allowable Values: 36 char max |
account_token
string
|
Unique identifier of the credit account for which to transition a status. Allowable Values: 36 char max |
original_status
string
|
Status of the credit account prior to transition. Allowable Values:
|
status
string
|
Status to which the credit account transitioned. Allowable Values:
|
created_time
datetime
|
Date and time when the transition record was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Resend credit event notification
Copy section link
Action: POST
Endpoint: /credit/webhooks/{event_type}/{resource_token}
Resends a credit event notification to your webhook endpoint.
Although you send this request as a POST, all parameters are passed in the URL and the body is empty.
The event notification is resent to your webhook endpoint and also returned in the response to this request.
For details on how to configure your webhook endpoint, see the About Webhooks tutorial.
For the complete /webhooks endpoint reference, see Webhooks.
URL path parameters
Copy section link
| Fields | Description |
|---|---|
event_type
string
|
Specifies the type of event you want to resend. Allowable Values:
|
resource_token
string
|
The unique identifier of the resource for which you want to resend a notification. Send a Send a Send a Send a Send a Send a Allowable Values: Existing journal entry token, ledger entry token, account transition token, payment transition token, statement summary token, or delinquency transition token |
Response body
Copy section link
| Fields | Description |
|---|---|
unused
string
|
The event notification that was resent to your webhook endpoint. Allowable Values: Valid event notification |
Sample response body
Copy section link
The following code block shows a sample of a resent creditaccounttransitions event.
The following code block shows a sample of a resent creditaccountstatements event.
The following code block shows a sample of a resent creditjournalentries event.
The following code block shows a sample of a resent creditledgerentries event.
The following code block shows a sample of a resent creditpaymenttransitions event.
The following code block shows a sample of a resent creditdelinquencytransitions event.