LElead
Compliance

Retrieve an account by client account ID

Changed on

Retrieves an account by the client_account_id you assigned, supplied as a query parameter: GET /v0/accounts?client_account_id=.... This is the filtered form of the accounts collection and is distinct from GET /v0/accounts/{id}, which takes the server-generated Account ID (account_*). The response body is identical to GET /v0/accounts/{id}.

get/v0/accounts

Request

  • Base URL
    https://api.sandbox.lead.bank
  • URL
    https://api.sandbox.lead.bank/v0/accounts
  • Auth
    HTTP bearer

Query parameters

client_account_idstring required

The client_account_id assigned to the account.

Response

Account object retrieved successfully.

idstring

The ID of the Account object.

created_atstring date-time

Creation timestamp

updated_atstring date-time

Last update timestamp

application_idstring

Unique identifier for the application. Prefixed with application_.

status'active' | 'inactive' | 'closed'

Current state of the account

status_reason'client_closed' | 'entity_closed' | 'frozen' | 'dormant' | 'active' | 'paid_off' | 'charged_off' | 'canceled' | 'other'

Machine-readable reason for the current status

capabilitiesAccountCapability[]

List of items that inform Lead how the Account will be used

metadataMetadata

A set of key-value pairs that can be used to store additional information related to this object.

client_account_idstring

Client-provided identifier for the account. Optional: present only for accounts created via file upload, and omitted for accounts created through the API, which are identified solely by their server-generated ID.

Example response

{
  "id": "account_xyz123",
  "application_id": "application_xyz123",
  "details": {
    "credit": {
      "currency": "USD"
    }
  },
  "documents": [
    {
      "document_id": "document_2N5Hk8xYmQpL9rBvC3jD",
      "version": "v1"
    }
  ]
}

Changes