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

# Retrieve direct deposit transition

> Retrieve a direct deposit transition.

GET/directdeposits/transitions/\{token}

Retrieve a direct deposit transition. Include the `token` path parameter to specify the record to return.

## URL path parameters

| Fields | Description |
| - | - |
| token string  Required | Identifies the direct deposit transition record to retrieve. **Allowable Values:**  Existing direct deposit transition token |

## Response body

| Fields | Description |
| - | - |
| channel string  Conditionally returned | Mechanism by which the transaction was initiated. **Allowable Values:**  `API`, `SYSTEM`, `PROD_SUPPORT` |
| token string  Conditionally returned | Unique identifier of the direct deposit transition record. **Allowable Values:**  36 char max |
| reason string  Conditionally returned | Explanation of why the direct deposit record is in the current state. **Allowable Values:**  255 char max |
| type string  Conditionally returned | Whether funds are being debited from or credited to the account. **Allowable Values:**  `CREDIT`, `DEBIT` |
| direct\_deposit\_token string  Conditionally returned | Unique identifier of the direct deposit record. **Allowable Values:**  36 char max |
| transaction\_token string  Conditionally returned | Unique identifier of the transaction record. **Allowable Values:**  36 char max |
| state string  Conditionally returned | Current status of the direct deposit record. **Allowable Values:**  `PENDING`, `APPLIED`, `REVERSED`, `REJECTED` |
| created\_time datetime  Conditionally returned | Date and time when the direct deposit record was created. **Allowable Values:**  string **Format:** yyyy-mm-ddThh:mm:ssZ |
| direct\_deposit\_account\_token string  Conditionally returned | Unique identifier of the direct deposit account record. **Allowable Values:**  36 char max |
| last\_modified\_time datetime  Conditionally returned | Date and time when the resource was last updated. **Allowable Values:**  string **Format:** yyyy-mm-ddThh:mm:ssZ |
| amount decimal  Conditionally returned | Amount being debited or credited. **Allowable Values:**  number **Format:** 0.00 |
| settlement\_date datetime  Conditionally returned | Date when the credit or debit is applied. **Allowable Values:**  datetime **Format:** yyyy-mm-ddThh:mm:ssZ |
| reason\_code string  Conditionally returned | Standardized code describing the reason for the current state. **Allowable Values:**  See [ACHR return reason codes](https://www.marqeta.com/docs/developer-guides/achr-return-reason-codes.md#_reason_codes_table) for the full list of supported codes and the grace period associated with each. |
| user\_token string  Conditionally returned | Unique identifier of the user associated with the direct deposit record **Allowable Values:**  Existing user token |
| business\_token string  Conditionally returned | Unique identifier of the business associated with the direct deposit record. **Allowable Values:**  Existing business token |
| standard\_entry\_class\_code string  Conditionally returned | Three-letter code identifying the type of entry. **Allowable Values:**  `ACK`, `ADV`, `ARC`, `ATX`, `BOC`, `CCD`, `CIE`, `COR`, `CTX`, `DNE`, `ENR`, `IAT`, `MTE`, `POP`, `POS`, `PPD`, `RCK`, `SHR`, `TEL`, `TRC`, `TRX`, `WEB`, `XCK` |
| company\_name string  Conditionally returned | Name of the direct deposit originator. **Allowable Values:**  16 char max |
| company\_discretionary\_data string  Conditionally returned | Company-specific data provided by the direct deposit originator. **Allowable Values:**  20 char max |
| company\_identification string  Conditionally returned | Alphanumeric code that identifies the direct deposit originator. **Allowable Values:**  10 char max |
| company\_entry\_description string  Conditionally returned | Description of the purpose of the direct deposit. **Allowable Values:**  10 char max |
| individual\_identification\_number string  Conditionally returned | Accounting number by which the recipient is known to the direct deposit originator. **Allowable Values:**  15 or 22 char max, depending on the value of `standard_entry_class_code` |
| individual\_name string  Conditionally returned | Identity of the direct deposit recipient. **Allowable Values:**  22 char max |
| trace\_number string  Conditionally returned | 15-digit number used to track inbound and outbound ACH transfers. **Allowable Values:**  15 char max |
| early\_direct\_deposit string  Conditionally returned | Boolean value that indicates whether this is a qualifying early pay transaction. If the early pay feature is not enabled for this program, this value will always be `false`. **Allowable Values:**  `true`, `false` |
| originator\_status\_code string  Conditionally returned | Numeric value that identifies the originator of the direct deposit record: - **1**: Originator is not a US federal government entity. - **2**: Originator is a US federal government entity, such as the IRS. **Allowable Values:**  1, 2 |


## Related topics

- [Direct Deposit Transitions Overview](https://www.marqeta.com/docs/core-api/ach-receiving/direct-deposit-transitions.md)
- [ACH Receiving Overview](https://www.marqeta.com/docs/core-api/ach-receiving.md)
- [List direct deposit transitions](https://www.marqeta.com/docs/core-api/ach-receiving/direct-deposit-transitions/list-direct-deposit-transitions-ach-receiving.md)
- [Direct Deposit](https://www.marqeta.com/docs/diva-api/direct-deposit.md)
- [Create direct deposit transition](https://www.marqeta.com/docs/core-api/ach-receiving/direct-deposit-transitions/create-direct-deposit-transition-ach-receiving.md)