---
title: "Get a Payer Account"
method: GET
path: "/payables/payer_accounts/{id}"
tags: ["Payer Accounts"]
---

# Get a Payer Account

`GET /payables/payer_accounts/{id}`

## Request

- Base URL: `https://api.justifi.ai/v1`
- URL: `https://api.justifi.ai/v1/payables/payer_accounts/{id}`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/justifi/apis/justifi-api-documentation/docs/payables/payer_accounts/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve a single payer account by its `payer_…` id.

## Path parameters

- `id` string, required

## Headers

- `Authorization` string, required

## Response `200`

Successfully retrieved the payer account

- object: the standard JustiFi response envelope for a single record
  - `id` string, required: the object id, also found in the data object
  - `type` string, required: the object type
  - `data` object, required: A payer account is the payer in Payables — a first-class Payables entity with its own `payer_…` id. Every payee, bank account, and payment is scoped to one payer account. Each payer account belongs to a JustiFi business (`business_id`). The record is created (`pending`) when a platform begins provisioning Payables, and becomes `active` once JustiFi's risk platform reports the business has met Payables's onboarding requirements — a lighter bar than our payments-processing product, so a business can be Payables-ready before it is enabled for payments. The customer-facing API exposes payer accounts read-only.
    - `id` string: unique payer account id
    - `type` string: the object type, matching the enclosing envelope's `type`
    - `business_id` string: the JustiFi business this payer account belongs to. Requests operate *within* a payer account (see the `/v1/payables/payer_accounts/{payer_id}/…` routes); `business_id` records the owning business for reporting and cross-account grouping, it is not the request scope. Discover a business's payer accounts with `GET /v1/payables/payer_accounts?business=biz_…`.
    - `name` string: display name for the payer account
    - `mode` 'test' | 'live': whether this payer account operates against real money. Inherited from the JustiFi account it belongs to — a test account and a live account are different accounts with different ids, so a payer account is one or the other for its life and cannot be switched. In `test`, payments run against a simulated ACH network: they complete in seconds rather than banking days, and no money moves.
    - `status` 'pending' | 'active' | 'disabled' | 'archived': the payer account's Payables lifecycle state, and what each state prevents. `pending` — provisioning has begun but the risk platform has not yet reported the business Payables-ready; `active` — Payables-ready, and the only state under which anything can be created; `disabled` — was active previously, and can no longer schedule payments, create payees or register bank accounts; `archived` — the same, and permanent: an archived payer account cannot be reactivated. A payment whose payee credit is already held is not paid out while the account is not `active`. It stays held until the account is active again, rather than failing.
    - `provisioned_at` string, date-time, nullable: when the payer account was provisioned to use Payables; null until provisioning completes
    - `funding_bank_account_id` string, nullable: pointer to the payer account's active funding bank account. In this version a payer account has a single active funding account. Null until one is registered and verified.
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `page_info` unknown, required

## Other responses

- `401`: The access token is missing, expired, or invalid.
- `403`: The credentials are valid but not permitted to access this resource.
- `404`: No resource exists for the given id (within the scoped payer account).
- `429`: The rate limit has been exceeded. Back off and retry after the interval indicated by the `Retry-After` header.

---

[API](https://skmtc.dev/justifi/apis/justifi-api-documentation.md) - [All operations](https://skmtc.dev/justifi/apis/justifi-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/justifi/apis/justifi-api-documentation/revisions/dd9f3fed7e46?raw)