Retrieve delinquency state
Action:GETEndpoint:
/credit/accounts/{account_token}/delinquencystate
Retrieve details of the current delinquency state of a credit account.
An account is delinquent when it is past due on payments and current when it is up to date on payments.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the credit account for which you want to retrieve delinquency state details. Send a GET request to /credit/accounts to retrieve existing credit account tokens.Allowable Values: Existing account token |
Response body
| Fields | Description |
|---|---|
| account_token string Returned | Unique identifier of the credit account. Allowable Values: Existing account token |
| is_delinquent boolean Returned | A value of true indicates that the account is currently delinquent.Allowable Values: true, false |
| date_account_delinquent datetime Conditionally returned | Date and time when the account last fell delinquent on the Marqeta platform, in UTC. If is_delinquent is false, a null value is returned.Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| date_account_current datetime Conditionally returned | Date and time when the account was last made current on the Marqeta platform, in UTC. If the account was never delinquent, this field returns the date and time the account was created on the Marqeta platform, in UTC. If is_delinquent is true, a null value is returned.Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| total_days_past_due integer Returned | Total number of days that the account is past due. Allowable Values: Any integer |
| delinquent_days_past_statement_end_date integer Conditionally returned | Total number of days that the account is past the oldest bucket’s statement end date. Allowable Values: Any integer |
| total_past_due decimal Returned | Total amount that is past due. Allowable Values: Format: 0.00 |
| current_due decimal Returned | Amount that is due for the current billing cycle. Allowable Values: Format: 0.00 |
| total_due decimal Returned | Total amount that is due for the current billing cycle; the sum of total_past_due_amount and current_due_amount.Allowable Values: Format: 0.00 |
| buckets array of objects Conditionally returned | One or more delinquency buckets for an account. Each delinquency bucket represents a billing cycle during which the account was delinquent. Allowable Values: One or more buckets objects |
| buckets[].bucket_number integer Returned | Delinquency bucket number in the returned array. Delinquency buckets are returned from most recent to least; the most recent delinquency bucket is 1.Allowable Values: Any integer |
| buckets[].payment_due_date datetime Returned | Date that the payment was due for this delinquency bucket. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| buckets[].past_due_carried_forward decimal Returned | Amount that is past due and carried forward from previous delinquency buckets. Allowable Values: Format: 0.00 |
| buckets[].current_due decimal Returned | Current amount that is due for this delinquency bucket. Allowable Values: Format: 0.00 |
| buckets[].total_due decimal Returned | Total amount that is due for this delinquency bucket; the sum of past_due_carried_forward and current_due.Allowable Values: Format: 0.00 |
| buckets[].days_past_due integer Returned | Total number of days that the payment is past due for this delinquency bucket. Allowable Values: Any integer |
Sample response body
The following code block shows details of a delinquent account.JSON
JSON
List delinquency state transitions
Action:GETEndpoint:
/credit/accounts/{account_token}/delinquencystate/transitions
Retrieve an array of delinquency state transitions for a credit account.
A delinquency state transition occurs when an account’s delinquency state transitions between delinquent and current. An account becomes delinquent when it falls behind on payments and becomes current when payments are made up to date.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the credit account whose delinquency state transitions you want to retrieve. Send a GET request to /credit/accounts to retrieve existing credit account tokens.Allowable Values: Existing account token |
URL query parameters
| Fields | Description |
|---|---|
| count integer Optional | Number of resources to retrieve. Allowable Values: 1 min |
| start_index integer Optional | Sort order index of the first resource in the returned array. Allowable Values: 0 min |
| sort_by string Optional | Field on which to sort. Prefix the field name with a hyphen (-) to sort in descending order. Omit the hyphen to sort in ascending order.NOTE: You must sort using system field names such as impactTime, and not by the field names appearing in response bodies such as impact_time.Allowable Values: impactTime, -impactTime |
Response body
| Fields | Description |
|---|---|
| count integer Returned | Number of resources returned. Allowable Values: 1-10 |
| start_index integer Returned | Sort order index of the first resource in the returned array. Allowable Values: Any integer |
| end_index integer Returned | Sort order index of the last resource in the returned array. Allowable Values: Any integer |
| is_more boolean Returned | A value of true indicates that more unreturned resources exist.Allowable Values: true, false |
| data array of objects Returned | List of delinquency state transitions. Allowable Values: Valid array of one or more delinquency state transitions |
| data[].token string Returned | Unique identifier of the delinquency state transition. Allowable Values: Existing delinquency transition token |
| data[].account_token string Returned | Unique identifier of the credit account. Allowable Values: Existing account token |
| data[].transition_trigger_reason string Returned | Event that triggered an update to the account’s delinquency state. Allowable Values: PAYMENT, PAYMENT_VOID, CREDIT, MINIMUM_PAYMENT_OVERRIDE, STATEMENT_GENERATION, REAGE, PAST_MIN_PAYMENT_DUE |
| data[].transition_trigger_time datetime Returned | Date and time when the triggering event caused the account’s delinquency state to transition, in UTC. For journal entries, equivalent to request_time. For statement journal entries, equivalent to impact_time,Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| data[].original_status string Returned | Original delinquency status prior to transition. Allowable Values: CURRENT, DELINQUENT |
| data[].status string Returned | Current delinquency status after transition. Allowable Values: CURRENT, DELINQUENT |
| data[].impact_time datetime Returned | Date and time when the triggering event impacted the account, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| data[].total_past_due decimal Conditionally returned | Total amount that is past due after the triggering event occurred. Equivalent to past_due_carried_forward for the account’s most recent delinquency bucket. To retrieve delinquency buckets for an account, send a GET request to /credit/accounts/{account_token}/delinquencystate.Allowable Values: Format: 0.00 |
| data[].current_due decimal Conditionally returned | Current amount that is due after the triggering event occurred. Equivalent to current_due for the account’s most recent delinquency bucket. To retrieve delinquency buckets for an account, send a GET request to /credit/accounts/{account_token}/delinquencystate.Allowable Values: Format: 0.00 |
| data[].total_due decimal Conditionally returned | Total amount that is due after the triggering event occurred; the sum of total_past_due and current_due.Equivalent to total_due for the account’s most recent delinquency bucket. To retrieve delinquency buckets for an account, send a GET request to /credit/accounts/{account_token}/delinquencystate.Allowable Values: Format: 0.00 |
| data[].oldest_payment_due_date datetime Conditionally returned | Payment due date of the account’s oldest delinquency bucket, in UTC. Useful when used with the delinquency state transition’s created_time to determine the total number of days a payment is past due.Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| data[].bucket_count decimal Conditionally returned | Number of buckets for the account after the triggering event occurred. Allowable Values: Any integer |
| data[].is_rolled_back boolean Returned | A value of true indicates that the system invalidated and rolled back the delinquency transition.This is a temporary field that allows Marqeta to handle occasional cases of out-of-order processing. This can occur when two delinquency state transition webhooks are sent near-simultaneously. For example, if a credit and a payment that bring an account current are made around the same time, two delinquency state transitions are sent very close together. In these cases, one of the transitions is rolled back and invalidated. For the transition that is rolled back, is_rolled_back is true and the transition should be ignored.This field is temporary and to be deprecated when out-of-order processing is addressed in a future release. Allowable Values: true, false |
| data[].created_time datetime Returned | Date and time when the delinquency state transition was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| data[].updated_time datetime Conditionally returned | Date and time when the delinquency state transition was last updated on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
Retrieve delinquency state transition
Action:GETEndpoint:
/credit/accounts/{account_token}/delinquencystate/transitions/{delinquency_transition_token}
Retrieve a specific delinquency state transition on a credit account.
A delinquency state transition occurs when an account’s delinquency state transitions between delinquent and current. An account becomes delinquent when it falls behind on payments and becomes current when payments are made up to date.
URL path parameters
| Fields | Description |
|---|---|
| account_token string Required | Unique identifier of the credit account whose delinquency state transition you want to retrieve. Send a GET request to /credit/accounts to retrieve existing credit account tokens.Allowable Values: Existing account token |
| delinquency_transition_token string Required | Unique identifier of the delinquency state transition. Allowable Values: Existing delinquency transition token |
Response body
| Fields | Description |
|---|---|
| token string Returned | Unique identifier of the delinquency state transition. Allowable Values: Existing delinquency transition token |
| account_token string Returned | Unique identifier of the credit account. Allowable Values: Existing account token |
| transition_trigger_reason string Returned | Event that triggered an update to the account’s delinquency state. Allowable Values: PAYMENT, PAYMENT_VOID, CREDIT, MINIMUM_PAYMENT_OVERRIDE, STATEMENT_GENERATION, REAGE, PAST_MIN_PAYMENT_DUE |
| transition_trigger_time datetime Returned | Date and time when the triggering event caused the account’s delinquency state to transition, in UTC. For journal entries, equivalent to request_time. For statement journal entries, equivalent to impact_time,Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| original_status string Returned | Original delinquency status prior to transition. Allowable Values: CURRENT, DELINQUENT |
| status string Returned | Current delinquency status after transition. Allowable Values: CURRENT, DELINQUENT |
| impact_time datetime Returned | Date and time when the triggering event impacted the account, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| total_past_due decimal Conditionally returned | Total amount that is past due after the triggering event occurred. Equivalent to past_due_carried_forward for the account’s most recent delinquency bucket. To retrieve delinquency buckets for an account, send a GET request to /credit/accounts/{account_token}/delinquencystate.Allowable Values: Format: 0.00 |
| current_due decimal Conditionally returned | Current amount that is due after the triggering event occurred. Equivalent to current_due for the account’s most recent delinquency bucket. To retrieve delinquency buckets for an account, send a GET request to /credit/accounts/{account_token}/delinquencystate.Allowable Values: Format: 0.00 |
| total_due decimal Conditionally returned | Total amount that is due after the triggering event occurred; the sum of total_past_due and current_due.Equivalent to total_due for the account’s most recent delinquency bucket. To retrieve delinquency buckets for an account, send a GET request to /credit/accounts/{account_token}/delinquencystate.Allowable Values: Format: 0.00 |
| oldest_payment_due_date datetime Conditionally returned | Payment due date of the account’s oldest delinquency bucket, in UTC. Useful when used with the delinquency state transition’s created_time to determine the total number of days a payment is past due.Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| bucket_count decimal Conditionally returned | Number of buckets for the account after the triggering event occurred. Allowable Values: Any integer |
| is_rolled_back boolean Returned | A value of true indicates that the system invalidated and rolled back the delinquency transition.This is a temporary field that allows Marqeta to handle occasional cases of out-of-order processing. This can occur when two delinquency state transition webhooks are sent near-simultaneously. For example, if a credit and a payment that bring an account current are made around the same time, two delinquency state transitions are sent very close together. In these cases, one of the transitions is rolled back and invalidated. For the transition that is rolled back, is_rolled_back is true and the transition should be ignored.This field is temporary and to be deprecated when out-of-order processing is addressed in a future release. Allowable Values: true, false |
| created_time datetime Returned | Date and time when the delinquency state transition was created on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
| updated_time datetime Conditionally returned | Date and time when the delinquency state transition was last updated on Marqeta’s credit platform, in UTC. Allowable Values: Format: yyyy-MM-ddThh:mm:ssZ |
Sample response body
JSON
Resend credit event notification
Action:POSTEndpoint:
/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
| Fields | Description |
|---|---|
| event_type string Required | Specifies the type of event you want to resend. Allowable Values: ledgerentry, journalentry, accounttransition, accountstatement, paymenttransition, delinquencytransition, paymentreminders, substatus, accountsignupbonus |
| resource_token string Required | Unique identifier of the resource for which you want to resend a notification. - Send a GET request to /credit/accounts/{account_token}/journalentries to retrieve existing journal entry tokens.- Send a GET request to /credit/accounts/{account_token}/ledgerentries to retrieve existing ledger entry tokens.- Send a GET request to /accounts/{account_token}/accounttransitions to retrieve existing account transition tokens.- Send a GET request to /credit/accounts/{account_token}/payments/{payment_token} to retrieve existing payment transition tokens.- Send a GET request to /accounts/{account_token}/statements to retrieve existing statement summary tokens.- Send a GET request to /accounts/{account_token}/delinquencystate/transitions to retrieve existing delinquency state transition tokens.- Send a GET request to /accounts/{account_token}/statements/{statement_summary_token}/paymentreminders/{token} to retrieve existing payment reminder tokens.- Send a GET request to /credit/substatuses to retrieve existing substatus tokens.- Send a GET request to /credit/accounts to retrieve existing credit account tokens and identify the specific account for the resend event.Allowable Values: Existing journal entry token, ledger entry token, account transition token, payment transition token, statement summary token, delinquency transition token, or substatus token |
Response body
| Fields | Description |
|---|---|
| unused string Conditionally returned | Event notification that was resent to your webhook endpoint. Allowable Values: Valid event notification |
Sample response body
The following code block shows a sample of a resentcreditaccounttransitions event.
JSON
creditaccountstatements event.
JSON
creditjournalentries event.
JSON
creditledgerentries event.
JSON
creditpaymenttransitions event.
JSON
creditdelinquencytransitions event.
JSON
substatus event.
JSON
accountsignupbonus event.
JSON