---
title: "Get a single bank account, with historical and entity data, by unique token or identifier."
method: GET
path: "/bank-accounts/{account_identifier_or_token}"
tags: ["Bank Accounts"]
---

# Get a single bank account, with historical and entity data, by unique token or identifier.

`GET /bank-accounts/{account_identifier_or_token}`

Retrieves a single bank account uniquely defined by a bank account token or external account identifier. Bank account tokens are alphanumeric characters that start with a prefix "A-". External account identifiers are strings provided by services or clients.

## Path parameters

- `account_identifier_or_token` string, required

## Query parameters

- `page` number
- `per_page` number

## Response `200`

Returns the bank account matching bank account token.

- object
  - `account_token` string
  - `timestamp` string, date-time — ISO 8601 timestamp of when the event occurred.
  - `external_account_id` string — Your system's unique identifier for the bank account.
  - `external_entity_id` string — Unique identifier of one of the Entities associated with the Account. Not strictly required if the event is not being monitored, but recommended to include for future proofing your integration. This field has no impact on which Entities are attached to the Account, although it should match at least one of the Entities that the Account belongs to. Click [here](https://developer.alloy.com/public/docs/api-request#source-workflow-impact-on-entity-fields) for more information.
  - `entity_token` string, nullable — Alloy-issued token of the entity associated with this account.
  - `account_class` 'credit' | 'deposit' | 'brokerage' | 'loan', nullable — The type of account. One of: credit, deposit (checking or savings), brokerage, loan.
  - `account_name` string, nullable — Descriptive name for the account.
  - `account_number` string — Account number, as it appears on statements or checks.
  - `routing_number` string, nullable — The ABA routing number for the bank account.
  - `opening_date` string, date-time, nullable — Date the account was opened.
  - `maturity_date` string, date-time, nullable — Date the account matures (for term-based accounts such as CDs or loans).
  - `closing_date` string, date-time, nullable — Date the account was or will be closed.
  - `cif_number` string, nullable — Customer Information File (CIF) number linking this account to a customer record in your core banking system.
  - `card_network` string, nullable — Payment card network associated with the account (e.g. Visa, Mastercard).
  - `country_code` string, nullable — 2-letter country code for the account.
  - `currency` string, nullable — Currency of the account (e.g. USD).
  - `product_code` string, nullable — Internal product code identifying the account product type in your system.
  - `product_name` string, nullable — Human-readable name of the account product.
  - `status` string, nullable — Current status of the account as defined in your system.
  - `status_detail` string, nullable — Free-form companion to the status field. Commonly used to communicate fraud labels on closed or restricted accounts (e.g. Fraud, potentialFraud, confirmedFraud). Any custom value is accepted.
  - `credit_limit` number, nullable — Credit limit of the account, in cents.
  - `account_balance` number, nullable — Current balance of the account, in cents.
  - `account_type_status` 'Written Off' | 'Active' | 'Refinanced' | 'Past Due' | 'Paid Off' | 'Cancelled', nullable — Lifecycle status of the account from a credit or loan servicing perspective.
  - `status_fraud` 'fraud' | 'not fraud', nullable — Indicates whether this account has been flagged as fraudulent. Set to fraud when the account is confirmed or suspected fraudulent, not fraud otherwise.
  - `entity_group_token` string, nullable — Alloy-issued token for the entity group associated with this account. When present, at least one entry in entities is required.
  - `external_entity_group_id` string, nullable — Your system's identifier for the entity group associated with this account. When present, at least one entry in entities is required.
  - `entities` union[]
    - union
      - object
        - `account_holder_type` 'primary' | 'secondary' | 'power_of_attorney' | 'authorized_signer' | 'authorized_user' | 'beneficiary' | 'joint_owner' | 'custodian' | 'guardian' | 'trustee'
        - `external_entity_id` string, required
        - `entity_token` string
      - object
        - `account_holder_type` 'primary' | 'secondary' | 'power_of_attorney' | 'authorized_signer' | 'authorized_user' | 'beneficiary' | 'joint_owner' | 'custodian' | 'guardian' | 'trustee'
        - `external_entity_id` string
        - `entity_token` string, required
  - `history` object[]
    - `timestamp` string, date-time
    - `status` string
    - `status_detail` string
    - `credit_limit` number
    - `account_balance` number
    - `status_fraud` 'fraud' | 'not fraud'
  - `entity_groups` object[]
    - `entity_group_token` string
    - `entity_group_name` string
    - `entity_group_type` 'business' | 'joint_account' | 'membership' | 'merchant'

## Other responses

- `404` — Unable to find the bank account token.

---

[API](https://skmtc.net/alloy/apis/alloy-api.md) · [All operations](https://skmtc.net/alloy/apis/alloy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/alloy/alloy-api/versions/405799de4d2a/schema)