Accounts

Retrieve connected biller accounts for your client. Accounts are created when a user successfully completes a link session.

Related guide: Link a Biller Account

The Account object

Attributes

Field	Type	Description
id*	string	Unique account identifier
biller_id*	string	The biller this account is linked to
biller_name*	string	Display name of the biller
client_user_id*	string	Your internal user identifier
status*	string	Account status: ACTIVE, INACTIVE, ERROR, DISCONNECTED
account_number	string	Masked account number (e.g., ****1234)
last_synced_at	string	ISO 8601 timestamp of the last successful sync
created_at	string	ISO 8601 timestamp when the account was linked
updated_at	string	ISO 8601 timestamp of last update

Example Account object

JSON

{
  "id": "acc_abc123",
  "biller_id": "test_electric_company",
  "biller_name": "Test Electric Company",
  "client_user_id": "user_456",
  "status": "ACTIVE",
  "account_number": "****1234",
  "last_synced_at": "2026-04-01T12:00:00Z",
  "created_at": "2026-03-15T09:30:00Z",
  "updated_at": "2026-04-01T12:00:00Z"
}

GET/bills/accounts

Get all connected biller accounts for your client. Returns a list of accounts that have been successfully linked through the BillerAPI link flow.

Response

{
  "accounts": [Account]
}

curl https://sandbox.api.billerapi.com/bills/accounts \
  -H "X-Client-ID: your_client_id" \
  -H "X-Client-Secret: your_client_secret"