GET//
Retrieves a direct deposit record. Include the token path parameter to indicate the direct deposit record to retrieve.
A direct deposit record stores the details corresponding to a single direct deposit action, such as the type (debit or credit), amount, and associated dates and times.
URL path parameters
| Fields | Description |
|---|---|
| token string Required | Unique identifier of the direct deposit record to retrieve. Allowable Values: Existing direct deposit record token |
Response body
| Fields | Description |
|---|---|
| amount decimal Conditionally returned | Amount being debited or credited. Allowable Values: number Format: 0.00 |
| business_token string Conditionally returned | Unique identifier of the business associated with the direct deposit record. Allowable Values: Existing business token |
| company_discretionary_data string Conditionally returned | Company-specific data provided by the direct deposit originator. Allowable Values: 20 char max |
| company_entry_description string Conditionally returned | Description of the purpose of the direct deposit. Allowable Values: 10 char max |
| company_identification string Conditionally returned | Alphanumeric code that identifies the direct deposit originator. Allowable Values: 10 char max |
| company_name string Conditionally returned | Name of the direct deposit originator. Allowable Values: 16 char max |
| 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 affected deposit account. Allowable Values: 36 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 |
| last_modified_time datetime Conditionally returned | Date and time when the direct deposit record was last updated. Allowable Values: string Format: yyyy-mm-ddThh:mm:ssZ |
| settlement_date datetime Conditionally returned | Date and time when the credit or debit is applied. Allowable Values: string Format: yyyy-mm-ddThh:mm:ssZ |
| 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 |
| state string Conditionally returned | Current status of the direct deposit record. Allowable Values: PENDING, APPLIED, REVERSED, REJECTED |
| state_reason string Conditionally returned | Explanation of why the direct deposit record is in the current state. Allowable Values: 255 char max |
| state_reason_code string Conditionally returned | Standardized code describing the reason for the current state. Allowable Values: See ACHR return reason codes for the full list of supported codes and the grace period associated with each. |
| token string Conditionally returned | Unique identifier of the direct deposit record. Allowable Values: 36 char max |
| type string Conditionally returned | Whether funds are being debited from or credited to the account. Allowable Values: CREDIT, DEBIT |
| user_token string Conditionally returned | Unique identifier of the user or business associated with the direct deposit record. Allowable Values: Existing user token |
| 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 |