Documentación · Modelo de datos
Metadatos de los conjuntos de datos
Cada colección incluye archivos legibles por máquina que la describen: cuándo se compiló, qué contiene, qué registros contribuyen y qué archivos descargar. Úselos para automatizar las descargas y comprobar que un archivo esté completo.
El catálogo
Un archivo enumera todas las colecciones con su versión actual, cifras y archivos:
/downloads/collections/index.jsonActualmente incluye — colecciones. Consúltelo periódicamente, compare el version de cada colección con el que usted tiene y vuelva a descargar solo cuando haya cambiado. Pueden añadirse colecciones; su código debe ignorar las que no reconozca.
Metadatos de la colección: index.json
Cada colección tiene su propio index.json, por ejemplo /downloads/collections/maritime/index.json. Sus campos:
| Sección | Campo | Descripción |
|---|---|---|
| — | scope | Nombre corto de la colección, usado en las rutas de archivos. |
| — | title | Nombre visible de la colección. |
| — | version | Versión de compilación: fecha y hora UTC de la compilación más un sufijo aleatorio corto. Cambia con cada compilación. |
| — | generated_at | Cuándo se generó la compilación. |
| — | last_change | Cuándo cambió el contenido por última vez respecto de la compilación anterior. |
| — | records | Número de registros (partes incluidas en las listas). |
| — | searchable | Registros con un nombre utilizable. |
| — | distinct_entities | Registros contados una vez por nombre depurado y fecha de nacimiento. Es una medida aproximada; consulte Identificadores. |
| — | sources | Número de registros de origen que contribuyen. |
| — | first_seen | Fecha más antigua en que se vio por primera vez cualquier registro. |
| — | last_processed | Fecha más reciente en que se confirmó algún registro en su publicador. |
types | type, records | Registros por tipo de entidad (nuestros códigos de tipo internos: INDIVIDUAL, COMPANY, ORGANIZATION, VESSEL, AIRCRAFT, UNKNOWN). |
countries | country, records | Registros por código de país (nacionalidad o país del registro). |
fill | name, alias, birthDate, … | Registros con al menos un valor para cada propiedad. Consulte llenado de campos. |
delta | added, modified, removed | Recuentos de cambios respecto de la compilación anterior, o null en la primera compilación. |
| — | licence | Un enlace a nuestra licencia de datos. |
files | name, type, path, bytes, rows, sha256 | Cada archivo de la colección con su tamaño, número de líneas y suma de verificación SHA-256. |
Cada compilación también agrega una línea a statistics.json con las mismas cifras, de la más reciente a la más antigua, que es lo que lee la página de estadísticas.
Metadatos de las fuentes: sources.json y la API
sources.json enumera los registros que contribuyen a una colección, un objeto por registro:
| Campo | Descripción |
|---|---|
name | Nombre del registro, tal como figura en nuestras páginas de fuentes. |
list | Nombre corto de la lista usado dentro de los registros. |
country | País o jurisdicción del publicador. |
records | Registros provenientes de este registro en la colección. |
first_seen | Cuándo se cargó el registro por primera vez. |
last_loaded | Carga más reciente. |
publisher_type | Tipo de fuente, como código interno (por ejemplo SANCTIONS_LIST, PEP_REGISTER, DEBARMENT_LIST, COURT_PORTAL). |
cadence_hours | Con qué frecuencia debe actualizarse la fuente, en horas. |
source_url | Página o fuente de datos del publicador. |
Los mismos detalles, con más cifras, están disponibles por registro en /api/source?name= y para todos los registros en /api/sources; consulte la referencia de puntos de acceso.
Campos que aún no publicamos: el nombre de la organización de un publicador y si es un organismo oficial (elemento 20 del backlog de datos), un indicador de obsoleto para las fuentes detenidas y una lista controlada de frecuencias de actualización.
Tipos de lista
En lugar de etiquetas libres, cada registro tiene un tipo de lista. Este determina a qué colecciones pertenece un registro y qué tema recibe.
| Tipo de lista | Significado | Tema | Colecciones |
|---|---|---|---|
SANCTION | Listas de sanciones, congelación de activos, terroristas y designaciones similares. | sanction | Crown Default, Sanciones consolidadas |
PEP | Registros de personas expuestas políticamente (PEP) y de titulares de cargos públicos. | role.pep | Crown Default, Personas expuestas políticamente |
DEBARMENT | Exclusiones de contratos públicos, programas de salud y profesiones reguladas. | debarment | Crown Default, Inhabilitación para contratar y medidas coercitivas |
TAX_WARRANT | Órdenes de cobro de impuestos y avisos públicos de ejecución similares. | reg.action | Crown Default, Inhabilitación para contratar y medidas coercitivas |
INSOLVENCY | Procedimientos de insolvencia publicados. | reg.action | Crown Default, Inhabilitación para contratar y medidas coercitivas |
La colección marítima no es un tipo de lista: contiene registros tipificados como buques o que tienen un número IMO, de cualquier tipo de lista. Algunos registros tienen hoy un tipo de lista incorrecto (elemento 33 del backlog de datos).
Los términos usados aquí se definen en el glosario.
Última actualización: 2026-10-04