> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usecroma.com/llms.txt
> Use this file to discover all available pages before exploring further.
# GLEIF (LEI)
> Todos los Legal Entity Identifiers del mundo, unos 3,4 millones: los nombres de la entidad, sus direcciones, jurisdicción, forma jurídica, número en su registro mercantil, estado y eventos, las matrices que reporta (consolidación directa y última, gestor de fondos, fondo paraguas, casa matriz) y por qué no reporta ninguna cuando no lo hace.
Un Legal Entity Identifier es el código de 20 caracteres que identifica a una
entidad jurídica en transacciones financieras y reportes regulatorios en todo
el mundo. Lo tienen bancos, fondos, emisores, sus filiales y cada vez más
empresas comunes. Cada registro LEI dice quién es la entidad (nombres,
direcciones, jurisdicción y forma jurídica), dónde está registrada y con qué
número, y qué entidades la poseen: las matrices directa y última que la
consolidan en sus cuentas, el gestor o el fondo paraguas de un fondo, la casa
matriz de una sucursal. Cuando una entidad no reporta matriz, el registro dice
por qué (propiedad de personas, no consolidada, ninguna persona conocida).
Todos los registros LEI, relaciones y excepciones de reporte, actualizados tres
veces al día. El número de registro es lo que une un LEI con un registro
mercantil: un file number de Delaware, un document number de Sunbiz, un NIT.
| `registration_authority` | Registro | `registered_as` |
| ------------------------ | --------------------------------------------------------- | ----------------------------------------- |
| `RA000602` | Delaware Division of Corporations | El file number, p. ej. `2758229` |
| `RA000603` | Florida Division of Corporations (Sunbiz) | El document number, p. ej. `L09000050533` |
| `RA999999` | Sin registro reportado | |
| `RA888888` | Otro registro, nombrado en `other_registration_authority` | |
Datos LEI de GLEIF, la Global Legal Entity Identifier Foundation, bajo CC0 1.0.
Croma no está afiliada a GLEIF, y GLEIF no respalda ni provee este servicio.
La fuente entera, organizada y lista para consultar: cada endpoint de esta página responde en milisegundos. Cada respuesta incluye `as_of`: qué tan actualizados están los datos. [Cómo funcionan los datasets](/es/datasets).
## Buscar entidades
`POST /global/gleif/entities-search/v1` Dataset
Busca en todos los registros LEI por cualquier combinación de nombre, lugar,
número de registro, categoría y estado.
| Campo | Tipo | Notas |
| ------------------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `query` | string | Opcional. Palabras del nombre legal o de cualquier otro nombre del registro. Todas deben coincidir; sin lematización. |
| `country` | string | Opcional. El país de dos letras de la dirección legal, p. ej. `US`, `CO`, `KY`. |
| `jurisdiction` | string | Opcional. La jurisdicción legal: un país (`GB`) o una subdivisión (`US-DE`, `US-FL`). |
| `registration_authority` | string | Opcional. El registro mercantil, por su código GLEIF (la tabla de arriba). |
| `registered_as` | string | Opcional. El número de la entidad en su registro, p. ej. un file number de Delaware. Úsalo con `registration_authority` para encontrar el LEI de una empresa que conoces por su registro. |
| `category` | enum | Opcional. `GENERAL`, `FUND`, `BRANCH`, `SOLE_PROPRIETOR`, `RESIDENT_GOVERNMENT_ENTITY` o `INTERNATIONAL_ORGANIZATION`. |
| `entity_status` | enum | Opcional. `ACTIVE` o `INACTIVE`. |
| `registration_status` | enum | Opcional. El estado del LEI: `ISSUED` (al día), `LAPSED` (no renovado), `RETIRED`, `DUPLICATE`, `ANNULLED`, `MERGED`, `PENDING_TRANSFER` o `PENDING_ARCHIVAL`. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-50. Por defecto `20`. |
```bash theme={"dark"}
curl https://api.croma.run/global/gleif/entities-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "query": "bancolombia" }'
```
Devuelve `as_of`, los filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` y `entities[]`, por nombre legal.
Cada entidad incluye `lei`, `legal_name`, `legal_name_language`, `other_names[]` y `transliterated_names[]` (`{ name, language, type }`), `all_names[]`, `legal_address` y `headquarters_address` (`{ first_line, number, number_within_building, mail_routing, additional_lines[], city, region, country, postal_code, language }`), `other_addresses[]` y `transliterated_addresses[]` (lo mismo, con un `type`), `country`, `jurisdiction`, `registration_authority`, `other_registration_authority`, `registered_as`, `category`, `sub_category`, `legal_form_code` (ISO 20275), `other_legal_form`, `associated_entity`, `entity_status`, `creation_date`, `expiration_date`, `expiration_reason`, `successor_entities[]`, `events[]` (eventos de la entidad: cambios de nombre, fusiones, disoluciones, con los campos que afectó cada uno), `initial_registration_date`, `last_update_date`, `registration_status`, `next_renewal_date`, `managing_lou`, `validation_sources`, `validation_authority`, `other_validation_authorities[]` y `conformity_flag`.
Los campos vacíos son `null`. Las fechas están en UTC, ISO 8601.
## Una entidad y sus matrices
`POST /global/gleif/entity/v1` Dataset
Resuelve un LEI y devuelve el registro, sus matrices y sus filiales.
| Campo | Tipo | Notas |
| ----- | ------ | ----------------------------------------- |
| `lei` | string | **Obligatorio.** El LEI de 20 caracteres. |
```bash theme={"dark"}
curl https://api.croma.run/global/gleif/entity/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "lei": "HWUPKR0MPOU8FGXBT394" }'
```
Devuelve `found`, `lei`, `as_of`, `entity` (null cuando no se encuentra), `direct_parent` y `ultimate_parent` (cada una una relación con `parent_name`, o null), `other_parents[]` (gestor de fondos, fondo paraguas, fondo maestro, casa matriz), `reporting_exceptions[]` (`{ category, reasons[], exception_references[] }`: por qué no se reporta matriz), `children[]` (hasta 100 relaciones que nombran a esta entidad como matriz, con `child_name`, las vigentes primero) y `children_total`.
Cada entidad incluye `lei`, `legal_name`, `legal_name_language`, `other_names[]` y `transliterated_names[]` (`{ name, language, type }`), `all_names[]`, `legal_address` y `headquarters_address` (`{ first_line, number, number_within_building, mail_routing, additional_lines[], city, region, country, postal_code, language }`), `other_addresses[]` y `transliterated_addresses[]` (lo mismo, con un `type`), `country`, `jurisdiction`, `registration_authority`, `other_registration_authority`, `registered_as`, `category`, `sub_category`, `legal_form_code` (ISO 20275), `other_legal_form`, `associated_entity`, `entity_status`, `creation_date`, `expiration_date`, `expiration_reason`, `successor_entities[]`, `events[]` (eventos de la entidad: cambios de nombre, fusiones, disoluciones, con los campos que afectó cada uno), `initial_registration_date`, `last_update_date`, `registration_status`, `next_renewal_date`, `managing_lou`, `validation_sources`, `validation_authority`, `other_validation_authorities[]` y `conformity_flag`.
Los campos vacíos son `null`. Las fechas están en UTC, ISO 8601.
Cada relación incluye `id`, `child_lei`, `parent_lei`, `relationship_type`, `relationship_status`, `periods[]` (`{ start_date, end_date, type }`), `qualifiers[]` (el estándar contable), `quantifiers[]` (el porcentaje de consolidación), `initial_registration_date`, `last_update_date`, `registration_status`, `next_renewal_date`, `managing_lou`, `validation_sources`, `validation_documents`, `validation_reference`, `current` y `withdrawn_at` (cuándo la retiró GLEIF, si lo hizo).
## Buscar relaciones
`POST /global/gleif/relationships-search/v1` Dataset
Lista las relaciones de una filial, de una matriz o de un tipo.
| Campo | Tipo | Notas |
| ------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `child_lei` | string | Opcional. El LEI de la entidad que reporta la relación. |
| `parent_lei` | string | Opcional. El LEI de la matriz, para listar todo lo que la reporta. |
| `relationship_type` | enum | Opcional. `IS_DIRECTLY_CONSOLIDATED_BY`, `IS_ULTIMATELY_CONSOLIDATED_BY`, `IS_INTERNATIONAL_BRANCH_OF`, `IS_FUND-MANAGED_BY`, `IS_SUBFUND_OF` o `IS_FEEDER_TO`. |
| `include_inactive` | boolean | Opcional. `true` para incluir las relaciones que GLEIF retiró. Por defecto `false`. |
| `page` | integer | Opcional. Página, empieza en 1. Por defecto `1`. |
| `per_page` | integer | Opcional. Resultados por página, 1-50. Por defecto `20`. |
```bash theme={"dark"}
curl https://api.croma.run/global/gleif/relationships-search/v1 \
-H "Authorization: Bearer $CROMA_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "parent_lei": "HWUPKR0MPOU8FGXBT394" }'
```
Devuelve `as_of`, los filtros aplicados, `total`, `page`, `per_page`, `total_pages`, `count` y `relationships[]`.
Cada relación incluye `id`, `child_lei`, `parent_lei`, `relationship_type`, `relationship_status`, `periods[]` (`{ start_date, end_date, type }`), `qualifiers[]` (el estándar contable), `quantifiers[]` (el porcentaje de consolidación), `initial_registration_date`, `last_update_date`, `registration_status`, `next_renewal_date`, `managing_lou`, `validation_sources`, `validation_documents`, `validation_reference`, `current` y `withdrawn_at` (cuándo la retiró GLEIF, si lo hizo).
Esquemas, todos los campos de respuesta y un playground interactivo.