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

# Get Accounts

> Lists every bank account registered under your client, for you and all of your users.

#### Request

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| Authorization | Header | Yes | `Bearer <access_token>` obtained from **POST /api/v1/client/token**. |
| page | Query | No | Page number, starting at 1. |
| pageSize | Query | No | Number of records per page. |

#### Response

Paginated responses share the same envelope: `items` (the records), `total`, `page`, `pageSize`, `orderBy` and `orderDirection`. Each item contains:

| Field | Description |
| --- | --- |
| id | Unique identifier of the bank account. Use it as destination in withdrawals and payouts. |
| status | Review status. The account can only be used when it is `APPROVED`. |
| name | Alias set when the account was registered. |
| number | Account number (or Bre-B key for `BREB` accounts). |
| type | `SAVING` or `CHECKING`. |
| currency | Currency of the account. |
| bankName | Banking entity. |
| registerDate | Date the account was registered. |
| userId | Owner of the account: your own user or one of your end users. |
| accountMetadata | Additional regional details (e.g. `ABA`, `CLABE`). |



## OpenAPI

````yaml /stack/openapi.json get /api/v1/admin/accounts
openapi: 3.1.0
info:
  title: Kravata Stack API
  version: '2.0'
  description: >-
    Kravata Stack API: users, accounts, custody wallets, liquidity ramps and
    fiat payments.
servers:
  - url: https://test-api-kore.kravata.co
    description: Test
  - url: https://partners-api.kravata.co
    description: Production (mTLS + IP allowlist)
security:
  - bearerAuth: []
tags:
  - name: Authentication
  - name: Users
  - name: Accounts
  - name: Earn
  - name: Custody
  - name: Liquidity Ramps
  - name: Payments
  - name: Webhooks
paths:
  /api/v1/admin/accounts:
    get:
      tags:
        - Accounts
      summary: Get Accounts
      description: >-
        Lists every bank account registered under your client, for you and all
        of your users.


        #### Request


        | Field | Type | Required | Description |

        | --- | --- | --- | --- |

        | Authorization | Header | Yes | `Bearer <access_token>` obtained from
        **POST /api/v1/client/token**. |

        | page | Query | No | Page number, starting at 1. |

        | pageSize | Query | No | Number of records per page. |


        #### Response


        Paginated responses share the same envelope: `items` (the records),
        `total`, `page`, `pageSize`, `orderBy` and `orderDirection`. Each item
        contains:


        | Field | Description |

        | --- | --- |

        | id | Unique identifier of the bank account. Use it as destination in
        withdrawals and payouts. |

        | status | Review status. The account can only be used when it is
        `APPROVED`. |

        | name | Alias set when the account was registered. |

        | number | Account number (or Bre-B key for `BREB` accounts). |

        | type | `SAVING` or `CHECKING`. |

        | currency | Currency of the account. |

        | bankName | Banking entity. |

        | registerDate | Date the account was registered. |

        | userId | Owner of the account: your own user or one of your end users.
        |

        | accountMetadata | Additional regional details (e.g. `ABA`, `CLABE`). |
      operationId: get-accounts
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        type:
                          type: string
                        number:
                          type: string
                        currency:
                          type: string
                        id:
                          type: string
                        userId:
                          type: string
                        bankName:
                          type: string
                        registerDate:
                          type: string
                        status:
                          type: string
                        accountMetadata:
                          type: array
                          items: {}
                  total:
                    type: integer
                  page: {}
                  pageSize: {}
                  orderBy: {}
                  orderDirection: {}
              examples:
                get-accounts:
                  summary: Get Accounts
                  value:
                    items:
                      - name: USERTEST
                        type: SAVING
                        number: '324223423'
                        currency: COP
                        id: 8fc7c60a-fd7c-4c23-a282-5fc1c1fc3a07
                        userId: 67960e40-0b5a-465d-8d78-610d7eff2785
                        bankName: ''
                        registerDate: '2026-07-03T18:15:56.477613'
                        status: APPROVED
                        accountMetadata: []
                    total: 1
                    page: null
                    pageSize: null
                    orderBy: null
                    orderDirection: null
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Access token from POST /api/v1/client/token.

````