> ## Documentation Index > Fetch the complete documentation index at: https://developers.circle.com/llms.txt > Use this file to discover all available pages before exploring further. # List all accounts > Retrieves the accounts available to the calling entity. ## OpenAPI ````yaml openapi/accounts.yaml get /v1/accounts openapi: 3.0.2 info: version: 1.0.0 title: Accounts (Stablecoin) API description: > Circle's Accounts API provides endpoints for managing stablecoin accounts -- including transfers, withdrawals, deposits, wire bank accounts, and blockchain addresses. An **Account** is a general representation of a ledger or custody object that holds balances. It can be a business account, a stablecoin account ledger for an end user, an extra sub-ledger, or any future custody solution. license: name: Circle License url: https://circle.com/terms servers: - url: https://api-sandbox.circle.com - url: https://api.circle.com security: [] tags: - name: Accounts description: Manage accounts. - name: Account Groups description: Manage custody account groups and their memberships. - name: Transactions description: | Get a unified, customer-friendly view of account transaction activity. - name: Transfers description: Manage account transfers. - name: Withdrawals description: Manage account bank withdrawals (fiat offramp). - name: Wires description: Manage account bank accounts for wire transfers. - name: Deposits description: Get information on account bank deposits. - name: Deposit Addresses description: Manage account deposit addresses. - name: Recipient Addresses description: Manage account recipient addresses used for transfers. paths: /v1/accounts: get: tags: - Accounts summary: List all accounts description: Retrieves the accounts available to the calling entity. operationId: listAccounts parameters: - $ref: '#/components/parameters/ClientEntityId' - name: type description: Filter by account type. in: query required: false schema: $ref: '#/components/schemas/AccountType' - name: purpose description: Filter by account purpose. in: query required: false schema: $ref: '#/components/schemas/AccountPurpose' - name: isAttributed description: > Filter by whether the account is attributed to another business or end user. `true` returns only attributed accounts; `false` returns only accounts the calling entity holds directly (not on behalf of another party). Combines with the `type` filter. For example, `type=first_party` with `isAttributed=true` returns only the parent entity's attributed accounts. in: query required: false schema: type: boolean example: true - $ref: '#/components/parameters/AccountStatusFilter' - $ref: '#/components/parameters/GroupIdFilter' - $ref: '#/components/parameters/From' - $ref: '#/components/parameters/To' - $ref: '#/components/parameters/PageBefore' - $ref: '#/components/parameters/PageAfter' - $ref: '#/components/parameters/PageSize' responses: '200': description: Successfully retrieved a list of accounts. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: $ref: '#/components/schemas/ListAccountsResponse' '401': $ref: '#/components/responses/NotAuthorized' '500': $ref: '#/components/responses/InternalServerError' security: - bearerAuth: [] components: parameters: ClientEntityId: name: clientEntityId description: >- Identifier of the client entity. Filters results to fetch only resources associated with the specified client entity. in: query required: false schema: type: string format: uuid example: a3f1b2c4-d5e6-7890-abcd-ef1234567890 AccountStatusFilter: name: status description: > Filter accounts by lifecycle status. Repeat the parameter to combine multiple statuses (e.g. `?status=active&status=archived`). When omitted, the default behavior excludes archived accounts. in: query required: false explode: true schema: type: array items: $ref: '#/components/schemas/AccountStatus' GroupIdFilter: name: groupId description: Filter accounts by the custody account group they belong to. in: query required: false schema: type: string format: uuid example: 9c0f1c0d-6c61-4f3d-9b8a-1a3a4b3c5d6e From: name: from description: >- Queries items created since the specified date-time (inclusive) in ISO 8601 format. in: query required: false schema: $ref: '#/components/schemas/UtcTimestamp' To: name: to description: >- Queries items created before the specified date-time (inclusive) in ISO 8601 format. in: query required: false schema: $ref: '#/components/schemas/UtcTimestamp' PageBefore: name: pageBefore description: >- A collection ID value used for pagination. It marks the exclusive end of a page. When provided, the collection resource will return the next `n` items before the id, with `n` being specified by `pageSize`. in: query required: false schema: type: string example: def9520a-5280-4089-9b02-3c9ef8fc8514 PageAfter: name: pageAfter description: >- A collection ID value used for pagination. It marks the exclusive beginning of a page. When provided, the collection resource will return the next `n` items after the id, with `n` being specified by `pageSize`. in: query required: false schema: type: string example: bce1e961-bdb8-4983-a9c2-0b3fbc2614cf PageSize: name: pageSize description: > Limits the number of items to be returned. Some collections have a strict upper bound that will disregard this value. In case the specified value is higher than the allowed limit, the collection limit will be used. If omitted, the collection will determine the page size itself. in: query required: false schema: type: integer minimum: 1 example: 5 schemas: AccountType: type: string description: | External account type. - `first_party`: the calling entity itself owns the account. - `third_party`: a sub-entity or end user owns the account. enum: - first_party - third_party example: first_party AccountPurpose: type: string description: | Intended use of the account. - `custody`: the account holds stablecoin balances for the owning entity. This is the default for new accounts. - `payments`: the account is used for Managed Payments products. enum: - custody - payments example: custody ListAccountsResponse: title: ListAccountsResponse properties: data: type: array items: $ref: '#/components/schemas/Account' AccountStatus: type: string description: > Lifecycle status of the account. - `active`: account is fully operational. - `pending`: account has been created but is not yet operational. - `rejected`: account creation was rejected and the account cannot be used. - `archived`: account has been archived and is excluded from default listings. Most mutating operations on the account (transfers, withdrawals, new address generation, etc.) are blocked while archived. enum: - active - pending - rejected - archived example: active UtcTimestamp: type: string description: ISO-8601 UTC date/time format. example: '2020-04-10T02:13:30.000Z' XRequestId: type: string format: uuid example: 2adba88e-9d63-44bc-b975-9b6ae3440dde Account: type: object description: An account exposed by the Accounts API. required: - accountId - entityId - type - purpose - status - description - balances properties: accountId: type: string description: Identifier of the account. example: '1000662322' entityId: type: string format: uuid description: Identifier of the owning entity. example: a49f9b1d-75e0-44a9-b8d2-4293b3f11ebd clientEntityId: type: string format: uuid description: Identifier of the client entity, if applicable. example: a3f1b2c4-d5e6-7890-abcd-ef1234567890 type: $ref: '#/components/schemas/AccountType' purpose: $ref: '#/components/schemas/AccountPurpose' status: $ref: '#/components/schemas/AccountStatus' description: type: string description: Human-readable description of the account. example: End User Wallet balances: type: array description: Balances currently associated with the account. items: $ref: '#/components/schemas/Money' businessPii: $ref: '#/components/schemas/BusinessPii' description: > PII for the business sub-client associated with a Managed Payments intermediary account. Omitted for accounts that are not Managed Payments intermediary accounts. groupId: type: string format: uuid nullable: true description: > Identifier of the custody account group this account belongs to, or `null` if it is not assigned to any group. Each account can belong to at most one group at a time. example: 9c0f1c0d-6c61-4f3d-9b8a-1a3a4b3c5d6e Error: type: object required: - code - message properties: code: type: integer example: 400 message: type: string example: Something went wrong. Money: type: object required: - amount - currency properties: amount: type: string description: Magnitude of the amount, in units of the currency, with a `.`. example: '3.14' currency: type: string description: Currency code for the amount. enum: - USD - EUR BusinessPii: type: object description: PII for the business sub-client being onboarded. required: - businessName - businessUniqueIdentifier - identifierIssuingCountryCode - address properties: businessName: type: string example: Acme Corporation businessUniqueIdentifier: type: string description: e.g. EIN or company registration number. example: 12-3456789 identifierIssuingCountryCode: type: string description: ISO 3166-1 alpha-2. example: US address: $ref: '#/components/schemas/ManagedPaymentsAddress' ManagedPaymentsAddress: type: object description: Physical address of the business sub-client. required: - line1 - city - postalCode - country properties: line1: type: string description: Address line 1. example: 100 Pine Street line2: type: string description: Address line 2 (optional). example: Suite 2500 city: type: string example: San Francisco district: type: string description: State or province code. example: CA postalCode: type: string example: '94111' country: type: string description: ISO 3166-1 alpha-2 country code. example: US headers: XRequestId: description: > Circle-generated universally unique identifier (UUID v4). Useful for identifying a specific request when communicating with Circle Support. schema: $ref: '#/components/schemas/XRequestId' responses: NotAuthorized: description: >- The request has not been applied because it lacks valid authentication credentials. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: code: 401 message: Malformed authorization. InternalServerError: description: >- The server encountered an unexpected condition that prevented it from fulfilling the request. headers: X-Request-Id: $ref: '#/components/headers/XRequestId' content: application/json: schema: $ref: '#/components/schemas/Error' example: code: -1 message: 'Something went wrong. errId: 1f0b0c455e40f753f07b4f0ae6abd4b4' securitySchemes: bearerAuth: type: http scheme: bearer ````