> ## 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.

# Objeto Entity

> >-

Una entity es un titular legal de cuentas. Las entities definen la propiedad y la identidad en Transfers: cada cuenta pertenece a una entity y tu organización tiene una entity raíz, marcada con `is_root`. Una entity recorre un ciclo de vida de `status` desde `draft` hasta `operational` antes de poder transaccionar.

```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"
}
```

| Atributo       | Tipo    | Descripción                                                                                                                                                  |
| -------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`           | string  | Identificador único de la entity.                                                                                                                            |
| `object`       | string  | Tipo del objeto. Siempre `entity`.                                                                                                                           |
| `country_code` | string  | Código de país ISO 3166-1 alpha-2 de la entity, en minúsculas; por ejemplo `cl` o `mx`. `null` cuando no está definido.                                      |
| `holder_id`    | string  | RFC mexicano del propietario de la entity, sin puntos ni guiones. Para una entity extranjera, el valor es el RFC genérico para extranjeros `XEXX010101000`.  |
| `holder_name`  | string  | Nombre legal del propietario de la entity.                                                                                                                   |
| `is_root`      | boolean | Si es `true`, esta entity es la entity raíz de tu organización.                                                                                              |
| `mode`         | string  | Uno de `live` o `test`. Las entities creadas con una API key live son `live`; las creadas con una API key de test son `test`.                                |
| `status`       | string  | Estado actual de la entity. Uno de `draft`, `under_review`, `pending_signature`, `canceled`, `waiting_initialization`, `operational`, `rejected` o `paused`. |