Documentation · API de vérification

L’API des entités

Tout ce que nous détenons sur une fiche : ses champs, ses inscriptions, les autres registres qui nomment la même partie et la vue fusionnée qui les regroupe.

Récupérer une fiche

Transmettez l’ID d’une fiche tiré d’une correspondance ou d’un résultat de recherche. /api/entity/<id> et /api/entity?id=<id> sont équivalents; la forme avec chemin est à privilégier.

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 réponse (abrégée) :

{
  "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"
    }
  ]
}

La fiche contient tous les champs que nous détenons à son sujet, ainsi que :

  • related : les autres fiches actives de la même partie, provenant d’autres registres (jusqu’à 100). Ce sont les fiches qui partagent son ID d’entité fusionnée ou, à défaut, son nom exact et sa date de naissance.
  • listings : la fiche et ses fiches connexes réduites aux faits d’inscription (registre, programme, type de liste et sujets, dates d’inscription et de radiation de la liste, lien vers la source, première et dernière observation), regroupés dans une seule liste.
  • merged_entity_url : l’emplacement où récupérer la vue fusionnée, lorsque la fiche en possède une.

Notre propre présentation de cette même fiche se trouve sur la page qui lui est consacrée sur ce site : fiche 379781867.

Récupérer une entité fusionnée

Lorsque plusieurs registres nomment la même partie, leurs fiches partagent un ID d’entité fusionnée (entity_id, affiché sous la forme merged_entity dans les résultats de correspondance). Récupérez-la de la même manière :

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 vue fusionnée combine les fiches : caption (le nom le plus fréquent), schema, properties (tous les noms, alias, dates de naissance, nationalités, numéros IMO et programmes), datasets, topics, first_seen, last_seen et referents (les ID des fiches à partir desquelles elle a été constituée). Par défaut, elle imbrique également listings et l’ensemble de records. Avec ?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
  ]
}

Les anciennes formes de requête /api/entity?id= et /api/entity?entity_id= fonctionnent toujours.

Vue à plat ou imbriquée

?nested=false renvoie uniquement la fiche (ou l’entité fusionnée), sans related, listings ni records. Utilisez-le lorsque vous avez seulement besoin de confirmer qu’une fiche est toujours active, ou lorsque vous interrogez de nombreux ID à intervalles réguliers.

Format FollowTheMoney

Ajoutez ?format=ftm pour obtenir une fiche selon la même structure FollowTheMoney qu’une ligne de entities.ftm.json dans les fichiers en masse; ajoutez &nested=true pour obtenir la structure de targets.nested.json, l’entité Sanction figurant sous properties.sanctions. L’ID des fichiers en masse (crown-379781867) est également accepté dans le chemin.

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

Maintenir à jour vos ID stockés

Si vous conservez les ID de fiches avec vos décisions de vérification, contrôlez-les de temps à autre :

  • Une fiche active répond 200.
  • Une fiche qui n’est plus active, mais dont l’entité fusionnée compte encore des fiches actives, répond 308 avec un en-tête Location pointant vers /api/entity/<entity_id>. La plupart des clients HTTP le suivent automatiquement. Mettez à jour votre référence stockée vers l’entité fusionnée.
  • Une fiche qui n’est plus active et ne dispose d’aucune entité fusionnée active répond 404. La partie ne figure plus sur ce registre; examinez le dossier.

Les ID d’entités fusionnées peuvent changer lorsque des fiches sont liées ou dissociées. Conservez les ID de fiches (referents) en plus de l’ID fusionné afin de pouvoir reconstituer le lien.

À venir : Notre politique sur la stabilité des ID de fiches et d’entités fusionnées : durée pendant laquelle les ID retirés continuent d’être redirigés et fréquence à laquelle les clients devraient revérifier les ID stockés.

Fiches connexes au-delà de 100

Chaque fiche renvoie au plus 100 fiches connexes. Les fiches connexes ne sont pas encore paginées; pour les parties inscrites sur un plus grand nombre de registres, utilisez l’entité fusionnée, qui renvoie jusqu’à 200 fiches, ou les fichiers en masse.

Dernière mise à jour : 2026-10-03