Get ACH Token

Retrieves the stored ACH account details associated with a previously created token.

Request Headers

HeaderRequiredDescription
AuthorizationYesBearer YOUR_ACCESS_TOKEN
Content-TypeYesapplication/json

Path Parameters

ParameterTypeRequiredDescription
location_idstringYesIdentifier of the location that owns the token
tokenstringYesThe ACH token returned from the Tokenize endpoint

Response Fields

The response body contains a token object with the following fields:

FieldTypeDescription
token.customerBankRoutingNumberstringABA routing number
token.customerBankAccountLastFourstringMasked account number (last 4 digits visible)
token.customerBankAccountTypestringExamples: checking, savings
token.customerBankAccountClassificationstringExamples: personal_account, business
token.customerFirstNamestringAccount holder first name
token.customerLastNamestringAccount holder last name
token.customerAddressstringStreet address
token.customerCitystringCity
token.customerStatestringState (2-letter code)
token.customerZipCodestringZIP code
token.customerCountrystringCountry
token.customerPhonestringPhone number (partially masked)
token.customerEmailstringEmail address (partially masked)

Response Examples

200 — Success

{
  "token": {
    "customerBankRoutingNumber": "091000022",
    "customerBankAccountLastFour": "****3632",
    "customerBankAccountType": "checking",
    "customerBankAccountClassification": "personal_account",
    "customerFirstName": "David",
    "customerLastName": "NANAS",
    "customerAddress": "2711 Park Blvd",
    "customerCity": "Seattle",
    "customerState": "WA",
    "customerZipCode": "98101",
    "customerCountry": "USA",
    "customerPhone": "***-***-9765",
    "customerEmail": "da*****[email protected]"
  }
}

404 — Token Not Found

Returned when the token does not exist or belongs to a different location.

{
  "error": {
    "code": 0,
    "name": "ach_generic",
    "message": "ACH token not found",
    "details": []
  }
}

Notes

  • Sensitive fields such as phone number and email address are partially masked in the response.
  • Returns 404 Not Found if the token does not exist or belongs to a different location.

Path Params
string
required
string
required
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain
application/json