---
title: "List entities"
method: GET
path: "/entities"
tags: ["Entities"]
---

# List entities

`GET /entities`

Lists the entities of your organization for the mode (`live` or `test`) of the API key used. An entity is a legal holder of accounts and defines ownership and identity in Transfers. 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

- `starting_after` string
- `ending_before` string
- `limit` integer

## Response `200`

List of entities for the current mode.

- Entity[]
  - `id` string, required — Unique identifier of the entity.
  - `object` 'entity', required — Type of the object. Always `entity`.
  - `country_code` string, nullable, required — ISO 3166-1 alpha-2 country code of the entity, in lowercase, or `null` when not set. For example, `cl` or `mx`.
  - `holder_id` string, required — Mexican tax ID (RFC) of the entity owner, without dots or hyphens. For a foreign entity, the value is the generic foreign RFC `XEXX010101000`.
  - `holder_name` string, required — Legal name of the entity owner.
  - `is_root` boolean, required — Whether this entity is your organization's root entity.
  - `mode` 'live' | 'test', required — Whether the entity belongs to `live` or `test` data. One of `live` or `test`.
  - `status` 'draft' | 'under_review' | 'pending_signature' | 'canceled' | 'waiting_initialization' | 'operational' | 'rejected' | 'paused', required — Current status of the entity. One of `draft`, `under_review`, `pending_signature`, `canceled`, `waiting_initialization`, `operational`, `rejected`, or `paused`.

## Other responses

- `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)