About this endpoint
What it does
Validates a routing number supplied on the request. Returns the checksum result, whether the number matches the FedACH reference data, and the bank record when a match is found.
Query Parameter(s)
| Attribute | Type | Mandatory | Description |
|---|---|---|---|
| routing_number | String | Yes | Routing number; exactly 9 characters long (minLength: 9, maxLength: 9). |
Response
Returns a JSON object with the validation result, checksum status, reference match status, the bank record when available, and attribution information.
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| input | String | Yes | The routing number supplied in the request. |
| normalized | String | Yes | The routing number after whitespace and separators are stripped. |
| checksum_valid | Boolean | Yes | true when the number passes the ABA checksum. |
| valid | Boolean | Yes | Overall verdict. true when the number passes the checksum and, where applicable, matches reference data. |
| reason | String | Yes | Why the verdict was reached, for example ok. |
| reference_status | String | Yes | Outcome of the reference-data lookup, for example matched. |
| reference_match | Boolean | Yes | true when the number was found in the FedACH reference data. |
| bank | Object | No | The matched bank record. Absent when no reference match was found. |
| bank.routing_number | String | No | The bank's 9-digit routing number. |
| bank.customer_name | String | No | Registered name of the institution. |
| bank.city | String | No | City. |
| bank.state | String | No | Two-letter state code. |
| bank.zip_code | String | No | ZIP code, including the +4 extension when present. |
| bank.phone | String | No | Contact phone number, digits only. |
| bank.institution_status_code | String | No | FedACH institution status code. |
| bank.source | String | No | Dataset the record came from, for example fedach. |
| bank.updated_at | String | No | When the record was last refreshed. Format: date-time. |
| attribution | Object Array | No | Source attribution entries for the dataset. Empty when no attribution is required. |



