---
title: "Get ACH stored token by Id"
method: GET
path: "/rest/v2/ach/tokens/{tokenId}"
tags: ["ACH Tokens"]
---

# Get ACH stored token by Id

`GET /rest/v2/ach/tokens/{tokenId}`

## Request

- The document declares no server URL.
- Auth: none declared. Required headers: `api-key`
- TypeScript: <https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow/docs/rest/v2/ach/tokens/:tokenId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the details of a stored ACH token using the specified token ID.

## Path parameters

- `tokenId` string, required

## Headers

- `api-key` string, required

## Response `200`

Success

- AchTokenResponsePayload: Payload
  - `ach-token` AchTokenResponse: Tokenized ACH account information.
    - `token-id` string: Unique identifier of the ACH token.
    - `times-used` integer: Number of times the token has been used in an ACH transaction.
    - `last-used` string: Date and time when the token was last used (UTC).
    - `merchant-id` string: The merchant's unique identification number associated with the token.
    - `routing-number` string: Bank routing number
    - `account-number` string: Masked or last four digits of the bank account number.
    - `account-type` 'Checking' | 'Savings': Type of the bank account. Possible values: Checking, Savings.
    - `individual-name` string: Name associated with the bank account.
    - `token-description` string: A brief description of the ACH token.
    - `created` string: Date and time when the token was created (UTC).
    - `updated` string: Date and time when the token was last updated (UTC).
    - `customer-key` string: Unique customer key associated with the token.
    - `default` boolean: Indicates whether this token is the default for the card number.
  - `payloadType` string: Indicates the type of payload returned in the response.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Business Exception
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal server error

---

[API](https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow.md) - [All operations](https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow/llms.txt) - [OpenAPI document](https://skmtc.dev/xplorpay/apis/external-us-onboarding-workflow/revisions/f37077c24b66?raw)