> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brale.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve all accounts

> Retrieve your client account and any managed accounts, returning account IDs, names, and KYB status.

Use the playground below to try this endpoint directly, or review the OpenAPI details in the right panel.

<Note>
  Account creation requires KYB / business details (see [Create a customer account](/api-reference/brale/create-account)), but account list responses return only this account summary for each account and do not include sensitive KYB details.
</Note>

## Response shape

`GET /accounts` returns a JSON array of Account summary objects. Each element matches the [Retrieve a customer account](/api-reference/brale/get-account) shape.

### Example

```json title="Response" theme={null}
[
  {
    "id": "2VcUIIsgARwVbEGlIYbhg6fGG57",
    "name": "ABC Company",
    "status": "complete",
    "created": "2026-01-01T00:00:00Z",
    "updated": "2026-01-01T00:00:00Z"
  },
  {
    "id": "34lCJZ2bxbPAzB3ou67Md01veUo",
    "name": "Managed Account Beta",
    "status": "pending",
    "created": "2026-01-15T12:00:00Z",
    "updated": "2026-01-15T12:00:00Z"
  }
]
```


## OpenAPI

````yaml GET /accounts
openapi: 3.0.3
info:
  title: Brale Issuance and Orchestration API
  version: 2.3.1
  description: >
    Brale supports stablecoin issuance and orchestration, enabling businesses
    and

    ecosystems to create their own stablecoins and convert between fiat and
    stablecoins

    seamlessly. From stablecoin onramps, offramps, and swaps to custody and
    payouts, the

    Brale API makes it easy to build stablecoin-enabled products.


    NOTE: All resource IDs (including account_id, address_id,
    financial_institution_id,

    and automation_id) are KSUIDs—26-character alphanumeric strings that are
    sortable

    by time. Examples showing UUIDs are incorrect.



    **What's new in 2.3.1**

    - Unified **Addresses** model for on-chain and off-chain endpoints
      - `Transfers` now accepts **address_id only** (no financial_institution_id)
      - Optional `brand` object to control bank statement presentation (`branding` still accepted as legacy alias)
    - Added off-chain rails: `ach_credit`, `same_day_ach_credit`, `ach_debit`,
    `same_day_ach_debit`, `rtp-credit`

    - Plaid endpoints moved to `/accounts/{account_id}/plaid/*`

    - `Financial Institutions` marked **deprecated** (migration path to
    **Addresses**)

    - Create Account now uses `CreateManagedAccountRequest` with
    `beneficial_owners`, `business_controller`, and `EndUserTosAttestation`.

    - Transfers now accept `brand` (replaces `branding`, still aliased in docs).

    - Plaid endpoints updated to return `address_id` and accept
    `transfer_types`.

    - Off-chain Address creation uses `CreateExternalAddressRequest` oneOf with
    bank + blockchain variants.

    - FI endpoints kept but marked deprecated; use Addresses instead.

    - `rtp_credit` is the canonical RTP rail name.
servers:
  - url: https://api.brale.xyz
    description: Production server
security:
  - BearerAuth: []
tags:
  - name: Accounts
    description: Endpoints related to managing customer accounts (KYB, details, etc.)
  - name: Transfers
    description: >-
      Endpoints for creating and retrieving transfers (fiat to stablecoins,
      etc.)
  - name: Addresses
    description: >-
      On-chain and off-chain endpoints (custodial or external) represented by a
      single Addresses resource
  - name: Financial Institutions
    description: Legacy (deprecated) bank endpoints. Use Addresses instead.
  - name: Automations
    description: Automated deposit addresses or onramps
  - name: Plaid
    description: Bank linking and ACH debit via Plaid.
  - name: Orders
    description: Legacy tag used for transfers in older specs.
paths:
  /accounts:
    get:
      tags:
        - Accounts
      summary: Retrieve all accounts
      description: Returns an array of accounts.
      operationId: listAccounts
      responses:
        '200':
          description: An array of accounts
          content:
            '*/*':
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Account'
components:
  schemas:
    Account:
      title: Account
      type: object
      description: >-
        Summary representation of a customer account returned by GET /accounts
        and GET /accounts/{account_id}. Account creation requires KYB / business
        details (see `AccountCreateRequest` / `CreateManagedAccountRequest`),
        but account read and list responses return only this account summary and
        do not return sensitive KYB details.
      properties:
        id:
          $ref: '#/components/schemas/Ksuid'
        name:
          type: string
          description: Account / business display name returned by the API.
          example: ABC Company
        status:
          type: string
          description: KYB / onboarding status of the account.
          enum:
            - complete
            - pending
            - rejected
          example: complete
        created:
          type: string
          format: date-time
          description: When the account was created.
          example: '2026-01-01T00:00:00Z'
        updated:
          type: string
          format: date-time
          description: When the account was last updated.
          example: '2026-01-01T00:00:00Z'
      required:
        - id
        - name
        - status
      example:
        id: 2VcUIIsgARwVbEGlIYbhg6fGG57
        name: ABC Company
        status: complete
        created: '2026-01-01T00:00:00Z'
        updated: '2026-01-01T00:00:00Z'
    Ksuid:
      title: Kusid
      type: string
      format: ksuid
      pattern: ^[a-zA-Z0-9]{26}$
      example: 2VcUIIsgARwVbEGlIYbhg6fGG57
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >
        Use the Bearer token returned from the Auth endpoint via OAuth2
        client_credentials flow. Include the token in the "Authorization: Bearer
        <token>" header.

````