---
title: "List accounts"
method: GET
path: "/accounts"
tags: ["Accounts"]
---

# List accounts

`GET /accounts`

Lists the accounts of your organization for the `live` or `test` mode of the API key used. Filter by `entity_id` and `status`. The list is paginated. Use the `starting_after`, `ending_before`, and `limit` query parameters to move through the list. The `Link` response header carries the URLs to navigate the paginated list.

## Query parameters

- `entity_id` string
- `status` 'active' | 'blocked' | 'closed'
- `starting_after` string
- `ending_before` string
- `limit` integer

## Response `200`

List of accounts for the current mode.

- Account[]
  - `id` string, required — Unique identifier of the account.
  - `object` 'account', required — Type of the object. Always `account`.
  - `available_balance` integer, required — Available balance of the account, in the smallest currency unit. For MXN the smallest unit is the centavo; for CLP it is the peso, which has no minor unit.
  - `currency` 'CLP' | 'MXN', required — ISO 4217 currency code of the account. One of `CLP`, `MXN`.
  - `description` string, nullable, required — Free-text description of the account, or `null` when none is set.
  - `entity` object, required — Owner entity of the account.
    - `id` string, required — Identifier of the entity.
    - `holder_id` string, required — Tax identifier of the owner. A Chilean tax ID (RUT) or a Mexican tax ID (RFC).
    - `holder_name` string, required — Legal name of the owner.
    - `is_root` boolean, required — Whether this entity is the root entity.
  - `is_root` boolean, required — Whether this account is the organization's root account.
  - `mode` 'live' | 'test', required — Whether the account holds `live` or `test` data.
  - `root_account_number` string, required — Default account number of the account. In Mexico, the 18-digit standardized bank account number (CLABE); in Chile, the bank account number.
  - `root_account_number_id` string, required — Identifier of the default account number.
  - `status` 'active' | 'blocked' | 'closed', required — Status of the account. One of `active`, `blocked`, `closed`.

## Other responses

- `400` — The request parameters are invalid.
- `401` — Invalid or missing API key.

---

[API](https://skmtc.net/fintoc/apis/fintoc-api.md) · [All operations](https://skmtc.net/fintoc/apis/fintoc-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fintoc/fintoc-api/revisions/9dafa63688a3/schema)