ALalloy
Bank Accounts

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

Changed on

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.

get/bank-accounts/{account_identifier_or_token}

Request

Path parameters

account_identifier_or_tokenstring required

Token of bank account to get details for.

Query parameters

pagenumber
Example:2

The page of history results to return. Default is 1.

per_pagenumber
Example:1000

How many history results per page to return. Default/maximum is 1000.

Response

Returns the bank account matching bank account token.

account_tokenstring
timestampstring date-time

ISO 8601 timestamp of when the event occurred.

external_account_idstring

Your system's unique identifier for the bank account.

external_entity_idstring

Your system's identifier for the entity this event is attributed to: the entity whose source workflow runs, whose data is hydrated into the resulting evaluation, and against which any published attribute values on this event are recorded.

This has no effect on which entities are linked to the account — entities controls that, as do add_entities and remove_entities on bank_account_updated — but it should name an entity the account already belongs to.

Required whenever the event triggers a source workflow or carries published attribute values; with no entity to attribute the event to, the request is rejected with a 400. It can be omitted for an event that is neither monitored nor carrying published attributes, but including it is recommended so the integration keeps working if a source workflow is added later. When both this and entity_token are supplied, entity_token wins.

Click here for more information.

external_session_idstring nullable

Optional identifier for correlating multiple events that belong to the same session.

entity_tokenstring nullable

Alloy-issued token of the entity this event is attributed to: the entity whose source workflow runs, whose data is hydrated into the resulting evaluation, and against which any published attribute values on this event are recorded. Takes precedence over external_entity_id when both are supplied.

This has no effect on which entities are linked to the account — entities controls that, as do add_entities and remove_entities on bank_account_updated — but it should name an entity the account already belongs to.

Required whenever the event triggers a source workflow or carries published attribute values; with no entity to attribute the event to, the request is rejected with a 400.

account_class'credit' | 'deposit' | 'brokerage' | 'loan' nullable

The type of account. One of: credit, deposit (checking or savings), brokerage, loan.

account_namestring nullable

Descriptive name for the account.

account_numberstring

Account number, as it appears on statements or checks.

routing_numberstring nullable

The ABA routing number for the bank account.

opening_datestring date-time nullable

Date the account was opened.

maturity_datestring date-time nullable

Date the account matures (for term-based accounts such as CDs or loans).

closing_datestring date-time nullable

Date the account was or will be closed.

cif_numberstring nullable

Customer Information File (CIF) number linking this account to a customer record in your core banking system.

card_networkstring nullable

Payment card network associated with the account (e.g. Visa, Mastercard).

country_codestring nullable

2-letter country code for the account.

currencystring nullable

Currency of the account (e.g. USD).

product_codestring nullable

Internal product code identifying the account product type in your system.

product_namestring nullable

Human-readable name of the account product.

statusstring nullable

Current status of the account as defined in your system.

status_detailstring 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_limitnumber nullable

Credit limit of the account, in cents.

account_balancenumber 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_tokenstring 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_idstring nullable

Your system's identifier for the entity group associated with this account. When present, at least one entry in entities is required.

Example response

{
  "account_token": "A-WO6WloK6odpcoxJkTKAt",
  "timestamp": "2024-06-01T12:00:00.000Z",
  "external_account_id": "acct-0a9b1c2d3e4f5a6b",
  "entity_token": "P-R21gUOQ8rwCvmx8tIscf",
  "account_class": "deposit",
  "account_name": "My Checking Account",
  "account_number": "123456789",
  "routing_number": "021000021",
  "opening_date": "2022-01-15T00:00:00.000Z",
  "maturity_date": "2027-01-15T00:00:00.000Z",
  "closing_date": "2025-06-01T00:00:00.000Z",
  "cif_number": "CIF-00123456",
  "card_network": "Visa",
  "country_code": "US",
  "currency": "USD",
  "product_code": "CHK-PREMIER",
  "product_name": "Premier Checking",
  "status": "active",
  "status_detail": "Fraud",
  "credit_limit": 500000,
  "account_balance": 12345,
  "account_type_status": "Active",
  "status_fraud": "not fraud",
  "entity_group_token": "EG-Xk3mR8pLqN2wYvT1cZsA",
  "external_entity_group_id": "group-acct-0012"
}

Changes

  • 615aa97a5ddbRevision changes
    • info

      added to the response body allOf list for the response status

    • info

      removed subschema #2 from the response body allOf list for the response status