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

# The Entity object

> A legal holder of accounts. Entities define ownership and identity in Transfers.

An `Entity` represents the legal holder of one or more `Account` objects. Fintoc returns an `Entity` object when you list or retrieve your organization's entities. Your organization has one root `Entity`, indicated by `is_root`; an entity progresses from `draft` to `operational` before it can transact.

The `Entity` object has the following attributes:

| Attribute      | Type      | Description                                                                                                                                                               |
| -------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`           | `string`  | Unique identifier for this object.                                                                                                                                        |
| `object`       | `string`  | Type of the object. Always `entity`.                                                                                                                                      |
| `country_code` | `string`  | ISO 3166-1 alpha-2 country code of the entity, in lowercase, for example `cl` or `mx`. `null` when not set.                                                               |
| `holder_id`    | `string`  | Mexican tax ID (RFC) of the entity owner, without dots or hyphens. The example uses the placeholder `AAA010101AAA`. Foreign entities use the generic RFC `XEXX010101000`. |
| `holder_name`  | `string`  | Legal name of the entity owner.                                                                                                                                           |
| `is_root`      | `boolean` | If `true`, this entity is your organization's root entity.                                                                                                                |
| `mode`         | `string`  | API key mode used to create the entity. One of `live` or `test`.                                                                                                          |
| `status`       | `string`  | Current status of the entity. One of `draft`, `under_review`, `pending_signature`, `canceled`, `waiting_initialization`, `operational`, `rejected`, or `paused`.          |

```json Entity object theme={null}
{
  "id": "ent_2daFu0zqqDtZGJaSi2TGI2Mm1nN",
  "object": "entity",
  "country_code": "mx",
  "holder_id": "AAA010101AAA",
  "holder_name": "Test Entity 1",
  "is_root": true,
  "mode": "test",
  "status": "operational"
}
```