La API de entidades

Todo lo que conservamos sobre un registro: sus campos, sus inclusiones en listas, los demás registros que nombran a la misma parte y la vista fusionada que los reúne.

Obtener un registro

Indique un ID de registro tomado de una coincidencia o de un resultado de búsqueda. /api/entity/<id> y /api/entity?id=<id> son equivalentes; se recomienda la forma con la ruta.

curl "https://api.crownintelligence.net/api/entity/379781867"

import requests

BASE = "https://api.crownintelligence.net"
rec = requests.get(f"{BASE}/api/entity/379781867", timeout=60).json()
print(rec["name"], rec["register"], rec["topics"])
for listing in rec["listings"]:
    print(" -", listing["register"], listing["programme"], listing["listed_on"])

const BASE = "https://api.crownintelligence.net";
const rec = await (await fetch(`${BASE}/api/entity/379781867`)).json();
console.log(rec.name, rec.register, rec.topics);
for (const l of rec.listings) console.log(" -", l.register, l.programme, l.listed_on);

La respuesta (abreviada):

{
  "id": 379781867,
  "register": "UK FCDO — Consolidated UK Sanctions List",
  "name": "IGOR ALEXANDROVICH PUTIN",
  "alt_names": "ИГОРЬ АЛЕКСАНДРОВИЧ ПУТИН",
  "program": "The Russia",
  "list_type": "SANCTION",
  "entity_type": "INDIVIDUAL",
  "dob": "1953-03-30",
  "nationality": null,
  "entity_id": "deee1587-7cfd-4652-ba74-e81c176b84cd",
  "first_seen": "2026-09-24T11:23:00.065456+00:00",
  "loaded_at": "2026-09-24T11:23:00.065456+00:00",
  "topics": [
    "sanction"
  ],
  "merged_entity_url": "/api/entity/deee1587-7cfd-4652-ba74-e81c176b84cd",
  "related": [],
  "listings": [
    {
      "record_id": 379781867,
      "register": "UK FCDO — Consolidated UK Sanctions List",
      "list_type": "SANCTION",
      "topics": [
        "sanction"
      ],
      "programme": "The Russia",
      "listed_on": null,
      "delisted_at": null,
      "status": null,
      "source_url": null,
      "first_seen": "2026-09-24T11:23:00.065456+00:00",
      "last_seen": "2026-09-24T11:23:00.065456+00:00"
    }
  ]
}

El registro incluye todos los campos que conservamos sobre él, además de:

related: otros registros activos de la misma parte, provenientes de otros registros (hasta 100). Son los registros que comparten su ID de entidad fusionada o, si no tiene uno, su nombre exacto y su fecha de nacimiento.
listings: el registro y sus registros relacionados reducidos a los datos de la inclusión en la lista (registro, programa, tipo de lista y temas, fechas de inclusión y de exclusión de la lista, enlace a la fuente, primera y última vez visto), anidados en una sola lista.
merged_entity_url: dónde obtener la vista fusionada, cuando el registro tiene una.

Nuestra propia presentación del mismo registro es su página en este sitio: registro 379781867.

Obtener una entidad fusionada

Cuando varios registros nombran a la misma parte, sus registros comparten un ID de entidad fusionada (entity_id, que aparece como merged_entity en los resultados de coincidencias). Se obtiene de la misma manera:

curl "https://api.crownintelligence.net/api/entity/deee1587-7cfd-4652-ba74-e81c176b84cd"

import requests

BASE = "https://api.crownintelligence.net"
ent = requests.get(f"{BASE}/api/entity/deee1587-7cfd-4652-ba74-e81c176b84cd", timeout=60).json()
print(ent["caption"], ent["schema"], ent["datasets"], ent["referents"])

La vista fusionada combina los registros: caption (el nombre más frecuente), schema, properties (todos los nombres, alias, fechas de nacimiento, nacionalidades, números IMO y programas), datasets, topics, first_seen, last_seen y referents (los ID de los registros a partir de los cuales se construyó). De forma predeterminada, también anida listings y el records completo. Con ?nested=false:

{
  "id": "deee1587-7cfd-4652-ba74-e81c176b84cd",
  "entity_id": "deee1587-7cfd-4652-ba74-e81c176b84cd",
  "caption": "IGOR ALEXANDROVICH PUTIN",
  "schema": "Person",
  "properties": {
    "name": [
      "IGOR ALEXANDROVICH PUTIN"
    ],
    "alias": [
      "ИГОРЬ АЛЕКСАНДРОВИЧ ПУТИН"
    ],
    "birthDate": [
      "1953-03-30"
    ],
    "nationality": [],
    "imoNumber": [],
    "programme": [
      "The Russia"
    ]
  },
  "datasets": [
    "UK FCDO — Consolidated UK Sanctions List"
  ],
  "topics": [
    "sanction"
  ],
  "first_seen": "2026-09-24T11:23:00.065456+00:00",
  "last_seen": "2026-09-24T11:23:00.065456+00:00",
  "referents": [
    379781867
  ]
}

Las formas de consulta anteriores /api/entity?id= y /api/entity?entity_id= siguen funcionando.

Plano o anidado

?nested=false devuelve solo el registro (o la entidad fusionada), sin related, listings ni records. Úselo cuando solo necesite confirmar que un registro sigue activo, o cuando consulte periódicamente muchos ID.

Formato FollowTheMoney

Agregue ?format=ftm para obtener un registro con la misma estructura FollowTheMoney que una línea de entities.ftm.json en los archivos masivos; agregue &nested=true para obtener la estructura de targets.nested.json, con la entidad Sanction bajo properties.sanctions. El ID de los archivos masivos (crown-379781867) también se acepta en la ruta.

curl "https://api.crownintelligence.net/api/entity/crown-379781867?format=ftm"

{
  "id": "crown-379781867",
  "caption": "IGOR ALEXANDROVICH PUTIN",
  "schema": "Person",
  "properties": {
    "name": [
      "IGOR ALEXANDROVICH PUTIN"
    ],
    "topics": [
      "sanction"
    ],
    "alias": [
      "ИГОРЬ АЛЕКСАНДРОВИЧ ПУТИН"
    ],
    "birthDate": [
      "1953-03-30"
    ],
    "notes": [
      "Nat: Russia · DOB: 30/03/1953 · Individual · Ref: RUS1424"
    ]
  },
  "referents": [],
  "datasets": [
    "uk_fcdo_consolidated_uk_sanctions_list"
  ],
  "first_seen": "2026-09-24T11:23:00.065456+00:00",
  "last_seen": "2026-09-24T11:23:00.065456+00:00",
  "last_change": "2026-09-24T11:23:00.065456+00:00",
  "target": true,
  "canonical_id": "crown-e-deee1587-7cfd-4652-ba74-e81c176b84cd"
}

Cómo mantener actualizados los ID almacenados

Si almacena ID de registros junto con sus decisiones de verificación, revíselos de vez en cuando:

Un registro activo responde 200.
Un registro que ya no está activo, pero cuya entidad fusionada aún tiene registros activos, responde 308 con un encabezado Location que apunta a /api/entity/<entity_id>. La mayoría de los clientes HTTP lo siguen automáticamente. Actualice su referencia almacenada a la entidad fusionada.
Un registro que ya no está activo y no tiene una entidad fusionada vigente responde 404. La parte ya no figura en ese registro; revise el caso.

Los ID de entidad fusionada pueden cambiar cuando se vinculan o desvinculan registros. Almacene los ID de los registros (referents) junto con el ID fusionado para poder reconstruir el vínculo.

Por proporcionar: Nuestra política sobre la estabilidad de los ID de registros y de entidades fusionadas: durante cuánto tiempo los ID retirados siguen redirigiendo y con qué frecuencia los clientes deben volver a revisar los ID almacenados.

Registros relacionados más allá de 100

Cada registro devuelve como máximo 100 registros relacionados. Aún no hay paginación de registros relacionados; para las partes incluidas en más registros, utilice la entidad fusionada, que devuelve hasta 200 registros, o los archivos masivos.

Última actualización 2026-10-03