La réponse

Ce que renvoie une requête de correspondance, champ par champ, et comment lire un score.

Exemple de réponse

Une réponse réelle à une requête sur la collection sanctions avec limit=1 :

{
  "collection": "sanctions",
  "algorithm": "standard",
  "threshold": 0.75,
  "limit": 1,
  "filters": {
    "topics": [],
    "include_dataset": [],
    "exclude_dataset": []
  },
  "responses": {
    "q1": {
      "status": 200,
      "query": {
        "schema": "Person",
        "name": [
          "Igor Putin"
        ],
        "birthDate": [
          "1953-03-30"
        ],
        "nationality": [
          "ru"
        ],
        "imo": []
      },
      "total": 1502,
      "results": [
        {
          "id": 379735083,
          "caption": "ПУТІН ІГОР ОЛЕКСАНДРОВИЧ",
          "schema": "Person",
          "score": 1,
          "match": true,
          "features": [
            {
              "feature": "name_match",
              "explanation": "'IGOR'≈'IGOR' exact 1.00 · 'PUTIN'≈'PUTIN' exact 1.00 · 'ALEKSANDROVICH' not in query",
              "score": 0.9,
              "weight": 1,
              "matched_name": "PUTIN IGOR ALEKSANDROVICH"
            },
            {
              "feature": "dob_match",
              "explanation": "query 1953-03-30 · record 1953-03-30 · match",
              "score": 0.1,
              "weight": 0.25
            },
            {
              "feature": "country_match",
              "explanation": "query RU · record RU · match",
              "score": 0.05,
              "weight": 0.1
            }
          ],
          "source": "Ukraine NSDC",
          "datasets": [
            "Ukraine NSDC"
          ],
          "topics": [
            "sanction"
          ],
          "list_type": "SANCTION",
          "programme": "UA NSDC",
          "birth_date": "1953-03-30",
          "nationality": "RU",
          "imo": null,
          "aliases": [
            "PUTIN IHOR OLEKSANDROVYCH",
            "PUTIN IGOR ALEKSANDROVICH",
            "ПУТИН ИГОРЬ АЛЕКСАНДРОВИЧ",
            "ПУТІН ІГОР ОЛЕКСАНДРОВИЧ"
          ],
          "merged_entity": "bbfc9049-d481-4d74-9062-3c98fd501194",
          "first_seen": "2026-09-24T11:21:48.933154+00:00",
          "last_seen": "2026-09-24T11:21:48.933154+00:00",
          "url": "/estate/record.html?id=379735083"
        }
      ]
    }
  },
  "checked_at": "2026-10-04T01:32:58.153Z"
}

Anatomie d’une réponse

Champ	Contenu
`collection`	La collection interrogée.
`algorithm`, `threshold`, `limit`	La méthode de calcul du score, le seuil et la limite de résultats appliqués.
`filters`	Les filtres de thèmes et de registres appliqués.
`responses`	Une entrée par requête, sous la clé que vous avez fournie.
`responses.<key>.status`	`200` lorsque la requête a été exécutée; `400` lorsqu’elle ne l’a pas pu (`error` en indique alors la raison, par exemple une requête sans nom ni numéro IMO).
`responses.<key>.total`	Le nombre de fiches candidates évaluées pour cette requête.
`responses.<key>.results`	Les fiches ayant obtenu les meilleurs scores, de la plus élevée à la plus faible, jusqu’à concurrence de `limit`.
`responses.<key>.query`	La requête telle que le service l’a interprétée.
`checked_at`	Le moment où la vérification a été effectuée, en UTC. Conservez-le avec votre dossier de vérification.

La requête analysée

query indique ce que l’outil de correspondance a réellement utilisé : le schéma, ainsi que les noms, dates de naissance, pays et numéros IMO qu’il a lus, une fois les alias de propriétés résolus. Si une valeur que vous avez envoyée est absente ici, c’est qu’elle figurait sous une propriété que l’outil ne lit pas. Comparez-la avec vos données d’entrée lorsqu’un résultat semble erroné.

Champs des résultats

id: L’ID de la fiche : une entrée dans un registre. Utilisez-le avec /api/entity/<id> et conservez-le avec votre décision.
caption: Le nom principal de la fiche tel que l’a rédigé l’éditeur.
schema: Type d’entité : Person, Company, Organization, Vessel, Airplane ou LegalEntity lorsque le type est inconnu.
score: De 0 à 1 : degré de ressemblance de la fiche avec votre requête, une fois toutes les caractéristiques appliquées.
match: Vrai lorsque score est égal ou supérieur au seuil de la requête.
features: L’explication : une entrée par caractéristique appliquée, avec feature, score (son effet), weight, un explanation lisible et, pour les noms, le matched_name qui s’est le mieux aligné.
datasets: Le registre dont provient la fiche, sous son nom complet. Utilisez ces noms dans include_dataset et exclude_dataset.
source: Le nom abrégé de la liste du registre tel qu’il est enregistré dans la fiche.
topics: Les étiquettes de risque de la fiche, par exemple sanction ou role.pep.
list_type: Le type de liste : SANCTION, PEP, DEBARMENT, TAX_WARRANT, INSOLVENCY.
programme: Le programme ou le fondement juridique que l’éditeur indique pour l’inscription, le cas échéant.
birth_date, nationalité, imo, alias: Les valeurs propres à la fiche, pour une comparaison côte à côte avec votre requête.
merged_entity: L’ID d’entité fusionnée lorsque cette partie a été liée entre plusieurs registres; consultez /api/entity/<merged_entity> pour obtenir la vue combinée.
first_seen, last_seen: Le moment où nous avons recueilli la fiche pour la première fois et celui de son dernier chargement depuis sa source.
url: La page de la fiche sur ce site.

Un score mesure la ressemblance, non le risque. Un score de 1 signifie que la fiche ressemble à votre requête; il n’indique pas que la partie est la même ni la gravité de l’inscription. Lisez topics, programme et la fiche elle-même, puis confirmez avec la liste officielle de l’éditeur avant d’agir.

Les résultats en détail

Les résultats de correspondance sont volontairement succincts. Pour obtenir la fiche complète, toutes les inscriptions et les autres registres qui nomment la même partie, appelez l’API des entités avec le id du résultat, ou ouvrez la page de la fiche à partir de url.

Traçabilité : l’origine de chaque valeur

Chaque résultat indique son registre. Pour l’historique valeur par valeur (quelle source a publié chaque nom ou chaque date, et quand elle a été vue pour la première et la dernière fois), utilisez statements.csv dans les fichiers en bloc. L’API ne comporte pas encore de point d’accès pour les déclarations.

Réduire les fausses alertes

Cherchez au bon endroit. Effectuez la vérification dans la collection que vos obligations exigent, et utilisez topics et les filtres de registres pour exclure les listes dont vous n’avez pas besoin.
Fournissez plus de détails. Une date de naissance, une nationalité ou un numéro IMO permet de départager les homonymes; sans ces éléments, toutes les personnes portant le même nom obtiennent un score semblable.
Fixez le seuil de façon réfléchie. Relevez-le pour réduire le bruit sur les noms courants, et conservez les explications avec chaque décision. Voir Ajustement.

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