Documentación · Modelo de datos
Diccionario de datos JSON
Todos los tipos de entidad y propiedades de nuestras descargas y de la API, los tipos de propiedad que utilizan y los temas que asignamos. El modelo sigue FollowTheMoney, el modelo de datos abierto que se usa en investigaciones y en datos de verificación, pero publicamos solo la parte que nuestras fuentes completan actualmente.
Entidades
Cada listado que recopilamos se convierte en una entidad: una persona, empresa, organización, embarcación o aeronave, con propiedades como su nombre, alias y fecha de nacimiento. Cada propiedad contiene una lista de valores, porque los editores a menudo indican más de uno. El listado en sí es una segunda entidad, de tipo Sanction, que apunta a la parte incluida en la lista e indica quién la publicó y bajo qué programa.
La estructura del objeto JSON, y lo que significan su ID, sus fechas y sus referencias, se explica en Estructura de la entidad. La forma en que se combinan las dos entidades en los archivos anidados se explica en Entidades planas y anidadas.
entities.ftm.json pueden leerse con las bibliotecas de código abierto de FollowTheMoney (paquete de Python, código fuente), que validan esquemas y tipos de propiedad. Un resumen legible por máquina del modelo (esquemas, campos de entidad, temas y archivos) se publica en model.json; el detalle por propiedad está en esta página.Tipos de esquema
Cada entidad tiene un esquema que indica qué tipo de elemento es y qué propiedades puede tener. Los esquemas se heredan unos de otros: un Person es un tipo de LegalEntity, que a su vez es un tipo de Thing. Nuestras fuentes nos proporcionan seis esquemas para las partes contra las que se verifica y uno para el listado.
Partes contra las que se puede verificar
Los conteos corresponden a registros de la colección Crown Default, leídos de su archivo de índice al cargar esta página.
| Esquema | Registros en Crown Default | Explorar |
|---|---|---|
Person | — | Buscar personas |
Company | — | Buscar empresas |
Organization | — | Buscar organizaciones |
LegalEntity | — | Buscar registros sin clasificar |
Vessel | — | Buscar embarcaciones |
Airplane | — | Buscar aeronaves |
Detalles del listado
| Esquema | Registros en Crown Default | Qué contiene |
|---|---|---|
Sanction | — | Uno por registro: el registro, el programa y la fecha del listado. |
FollowTheMoney define muchos más esquemas: direcciones, documentos de identidad, cargos ocupados, propiedad, cargos de director, vínculos familiares y de asociados, billeteras de criptomonedas y valores. Todavía no publicamos ninguno. Cuando un proveedor entrega esa información, se conserva tal como fue escrita en la propiedad notes. Convertirla en entidades propiamente dichas es trabajo planificado (elementos 9, 22, 23 y 32 del backlog de datos).
Esquemas y sus propiedades
Solo se enumeran las propiedades que realmente completamos para cada esquema. Cada tabla indica el nombre de la propiedad tal como aparece en el JSON, su tipo (véase Tipos de propiedad), la longitud en caracteres del valor individual más largo en la compilación de Crown Default del 3 de octubre de 2026, lo que contiene la propiedad y un valor real de ese esquema tomado de la misma compilación. Las longitudes cambian de una compilación a otra. Prevea valores largos: algunos proveedores colocan párrafos completos en un campo de nombre.
Persona
Una persona nombrada por un proveedor: una persona sancionada, una persona expuesta políticamente (PEP) o un profesional inhabilitado para contratar.
- Hereda de
- LegalEntity → Thing
- Referencia
- FollowTheMoney: Person
| Propiedad | Tipo | Valor más largo | Descripción | Ejemplo |
|---|---|---|---|---|
name | name | 2,041 | Nombre principal, exactamente como lo escribió el proveedor. | SULTAN AZIZ AZAM |
alias | name | 2,000 | Otros nombres, grafías y escrituras indicados por el proveedor. | AZIZ AZAM |
birthDate | date | 10 | Fecha de nacimiento, con la precisión que indique el proveedor. | 1985 |
nationality | country | 2 | Nacionalidad como código ISO 3166-1 en minúsculas. | af |
topics | topic | 10 | Motivo por el que la entidad figura en nuestros datos. Véase Temas de riesgo. | sanction |
notes | text | 485 | Otros datos del proveedor que aún no hemos separado en campos (direcciones, números de ID, indicadores). | Nat: AFGHANISTAN · DOB: 1985 |
sourceUrl | url | 79 | Página del proveedor correspondiente a este listado, cuando el proveedor la ofrece. Hoy solo se completa para los avisos de insolvencia franceses (BODACC). | un aviso en bodacc.fr |
Empresa
Una empresa u otro negocio comercial.
- Hereda de
- Organization → LegalEntity → Thing; también Asset
- Referencia
- FollowTheMoney: Company
| Propiedad | Tipo | Valor más largo | Descripción | Ejemplo |
|---|---|---|---|---|
name | name | 875 | Nombre principal, exactamente como lo escribió el proveedor. | FIRST CRIMEAN INSURANCE COMPANY |
alias | name | 887 | Otros nombres, grafías y escrituras indicados por el proveedor. | ATLANTIC LOTTERY |
country | country | 2 | País vinculado a la entidad por el proveedor, como código ISO 3166-1 en minúsculas. | kp |
imoNumber | identifier | 10 | Número de empresa de la IMO (el número de propietario registrado o de gestor de la IMO), tomado de los datos del proveedor. | IMO6166689 |
topics | topic | 10 | Motivo por el que la entidad figura en nuestros datos. Véase Temas de riesgo. | sanction |
notes | text | 214 | Otros datos del proveedor que aún no hemos separado en campos (direcciones, números de ID, indicadores). | Nat: RUSSIAN FEDERATION |
Organización
Un organismo no comercial: una agencia gubernamental, una asociación, un grupo armado o un partido político.
- Hereda de
- LegalEntity → Thing
- Referencia
- FollowTheMoney: Organization
| Propiedad | Tipo | Valor más largo | Descripción | Ejemplo |
|---|---|---|---|---|
name | name | 196 | Nombre principal, exactamente como lo escribió el proveedor. | 53RD ANTI-AIRCRAFT MISSILE BRIGADE |
alias | name | 48 | Otros nombres, grafías y escrituras indicados por el proveedor. | AMALGAMATED POL & ED CMTE OF PHILADELPHIA |
topics | topic | 9 | Motivo por el que la entidad figura en nuestros datos. Véase Temas de riesgo. | sanction |
notes | text | 33 | Otros datos del proveedor que aún no hemos separado en campos (direcciones, números de ID, indicadores). | Belgium |
LegalEntity
Una parte incluida en la lista cuyo tipo el publicador no indica y que no pudimos determinar a partir del registro.
- Hereda de
- Thing
- Referencia
- FollowTheMoney: LegalEntity
| Propiedad | Tipo | Valor más largo | Descripción | Ejemplo |
|---|---|---|---|---|
name | name | 513 | Nombre principal, exactamente como lo escribió el proveedor. | Volga-Dnepr Airlines |
alias | name | 55 | Otros nombres, grafías y escrituras indicados por el proveedor. | TW Pro / TW Plus |
topics | topic | 9 | Motivo por el que la entidad figura en nuestros datos. Véase Temas de riesgo. | sanction |
notes | text | 180 | Otros datos del proveedor que aún no hemos separado en campos (direcciones, números de ID, indicadores). | Switzerland |
Embarcación
Un buque, identificado por su número IMO cuando el publicador lo proporciona.
- Hereda de
- Vehículo → Activo → Cosa
- Referencia
- FollowTheMoney: Vessel
| Propiedad | Tipo | Valor más largo | Descripción | Ejemplo |
|---|---|---|---|---|
name | name | 42 | Nombre principal, exactamente como lo escribió el proveedor. | ARK III |
alias | name | 30 | Otros nombres, grafías y escrituras indicados por el proveedor. | UNIMARIN DENIZCILIK |
imoNumber | identifier | 10 | Número IMO del buque, leído de los detalles del publicador. | IMO9187655 |
topics | topic | 9 | Motivo por el que la entidad figura en nuestros datos. Véase Temas de riesgo. | sanction |
notes | text | 180 | Otros datos del proveedor que aún no hemos separado en campos (direcciones, números de ID, indicadores). | Vessel Registration Identification IMO 7206512. |
Airplane
Una aeronave, generalmente identificada por su matrícula.
- Hereda de
- Vehículo → Activo → Cosa
- Referencia
- FollowTheMoney: Airplane
| Propiedad | Tipo | Valor más largo | Descripción | Ejemplo |
|---|---|---|---|---|
name | name | 6 | Nombre principal, exactamente como lo escribió el proveedor. | F-OJHH |
topics | topic | 8 | Motivo por el que la entidad figura en nuestros datos. Véase Temas de riesgo. | sanction |
notes | text | 180 | Otros datos del proveedor que aún no hemos separado en campos (direcciones, números de ID, indicadores). | Aircraft Model Falcon 900B; Aircraft Manufacturer’s Serial Number (MSN) 133; Aircraft Tail Number YV2040. |
Sanction
La inclusión en la lista en sí: qué registro la publicó, bajo qué programa y cuándo. Cada registro tiene exactamente una entidad Sanction, cuyo ID es el ID del registro seguido de -sanction. El nombre es de FollowTheMoney: lo usamos para todos los tipos de lista, incluidos los registros de PEP, de inhabilitación para contratar y regulatorios.
- Hereda de
- Interval
- Referencia
- FollowTheMoney: Sanction
| Propiedad | Tipo | Valor más largo | Descripción | Ejemplo |
|---|---|---|---|---|
entity | entity | 15 | ID de la entidad incluida en la lista a la que se refiere esta inclusión. | crown-379597165 |
authority | string | 136 | El registro que publicó la inclusión. | OFAC SDN |
program | string | 2,754 | Programa, régimen o base legal tal como se publicó. Consulte El campo de programa. | RUSSIA-EO14024 |
sourceUrl | url | 79 | Página del proveedor correspondiente a este listado, cuando el proveedor la ofrece. Hoy solo se completa para los avisos de insolvencia franceses (BODACC). | un aviso en bodacc.fr |
listingDate | date | — | Fecha en que el publicador incluyó a la entidad en la lista. Está definido, pero no se completa en la compilación actual. | — |
Tipos de propiedades
Cada propiedad tiene un tipo que determina cómo se escriben sus valores.
| Tipo | Formato | Ejemplo |
|---|---|---|
| name | Texto libre, tal como se publicó. No se traduce ni se transcribe a otro alfabeto. | AZAM, SULTAN AZIZ |
| date | ISO 8601 con solo la precisión que indica el publicador: YYYY, YYYY-MM o YYYY-MM-DD. | 1985 |
| country | Código ISO 3166-1 alfa-2 en minúsculas. | af |
| identifier | Un número de registro o de buque. Hoy solo números IMO, escritos como IMO más siete dígitos. | IMO6922169 |
| topic | Un código de la lista de temas que figura más abajo. | role.pep |
| url | Una dirección web completa en el sitio del publicador. | https://… |
| text | Texto libre largo, no utilizado para coincidencias. | Nat: AFGHANISTAN · DOB: 1985 |
| string | Texto libre breve. | OFAC SDN |
| entity | El ID de otra entidad del mismo archivo. | crown-379597165 |
Los identificadores de empresas y valores, como LEI e ISIN, se conservan en nuestras tablas de registro, pero aún no forman parte de los archivos de entidades (elemento 13 de la lista pendiente de datos). Otros identificadores que imprimen los publicadores, como los números de pasaporte y fiscales, permanecen en notes hasta que se analicen (elemento 9).
Temas
Cada registro recibe un tema según el tipo de lista de la que proviene. La explicación completa y los temas que aún no asignamos se encuentran en Temas de riesgo.
| Tema | Significado |
|---|---|
sanction | Nombrado en una lista de sanciones |
role.pep | Persona expuesta políticamente (PEP) |
debarment | Inhabilitado para contratar con el sector público o excluido por un regulador |
reg.action | Nombrado en una medida regulatoria o de ejecución, incluidas órdenes fiscales y avisos de insolvencia |
El campo de programa
La propiedad program contiene el programa, régimen o base legal indicado por el publicador, exactamente como se publicó, por ejemplo RUSSIA-EO14024. Algunos publicadores usan el campo para otros fines, como un tipo de parte o una referencia de decisión, y conservamos su redacción. FollowTheMoney también define programId y programUrl; reservamos ambos hasta contar con un catálogo de programas con sus autoridades emisoras. Consulte Programas de sanciones y el directorio de programas.
Con qué frecuencia se completa cada campo
Proporción de registros de Crown Default con al menos un valor, según la compilación actual. Una cifra baja suele indicar que los publicadores no proporcionan ese detalle, o que aún no lo hemos extraído de notes.
| Propiedad | Registros con un valor | Proporción |
|---|---|---|
name | — | — |
alias | — | — |
birthDate | — | — |
nationality | — | — |
imoNumber | — | — |
program | — | — |
sourceUrl | — | — |
Glosario
Los términos usados aquí (registro de origen, colección, registro, entidad, entidad distinta, objetivo) se definen en la página Glosario.
| Vigencia | Significado breve |
|---|---|
| Registro de origen | Una lista de un publicador. |
| Colección | Un conjunto de registros con un mismo propósito. |
| Registro | Una inclusión de una parte en un registro. |
| Entidad distinta | Registros que comparten nombre y fecha de nacimiento, contados una sola vez. |
| Objetivo | La parte incluida en la lista, a diferencia de la inclusión. |
Columnas de descarga
El archivo simplificado targets.simple.csv tiene una fila por registro con estas columnas: id, schema, name, aliases, birth_date, countries, addresses, identifiers, sanctions, phones, emails, program_ids, dataset, first_seen, last_seen, last_change. Las columnas addresses, phones, emails y program_ids existen por compatibilidad y hoy están vacías. Las definiciones columna por columna se encuentran en Uso de los datos masivos.
Las descargas por registro desde una página de fuente usan un formato distinto y más antiguo: id, name, alt_names, list_type, entity_type, program, dob, nationality, entity_id, first_seen, loaded_at, source.
Última actualización: 2026-10-04