La respuesta

Lo que devuelve una solicitud de coincidencias, campo por campo, y cómo interpretar un puntaje.

Un ejemplo de respuesta

Una respuesta real a una consulta sobre la colección sanctions con 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"
}

Anatomía de una respuesta

Campo	Contenido
`collection`	La colección consultada.
`algorithm`, `threshold`, `limit`	El método de puntuación, el umbral y el límite de resultados que se aplicaron.
`filters`	Los filtros de temas y de registros que se aplicaron.
`responses`	Una entrada por consulta, bajo la clave que usted indicó.
`responses.<key>.status`	`200` cuando la consulta se ejecutó; `400` cuando no pudo ejecutarse (en ese caso `error` indica el motivo, por ejemplo una consulta sin nombre ni número IMO).
`responses.<key>.total`	Cuántos registros candidatos se puntuaron para esta consulta.
`responses.<key>.results`	Los registros con mejor puntaje, de mayor a menor, hasta `limit`.
`responses.<key>.query`	La consulta tal como la interpretó el servicio.
`checked_at`	Cuándo se ejecutó la verificación, en UTC. Consérvela junto con su registro de verificación.

La consulta analizada

query muestra lo que el motor de coincidencias realmente utilizó: el esquema y los nombres, fechas de nacimiento, países y números IMO que leyó, una vez resueltos los alias de las propiedades. Si aquí falta un valor que usted envió, estaba en una propiedad que el motor no lee. Compárelo con su entrada cuando un resultado parezca incorrecto.

Campos de los resultados

id: El ID del registro: una entrada en un registro. Úselo con /api/entity/<id> y guárdelo junto con su decisión.
caption: El nombre principal del registro tal como lo escribió el publicador.
schema: Tipo de entidad: Person, Company, Organization, Vessel, Airplane o LegalEntity cuando se desconoce el tipo.
score: De 0 a 1: qué tanto se parece el registro a su consulta, una vez aplicadas todas las características.
match: Verdadero cuando score es igual o superior al umbral de la solicitud.
features: La explicación: una entrada por cada característica aplicada, con feature, score (su efecto), weight, un explanation legible y, en el caso de los nombres, el matched_name que mejor se alineó.
datasets: El registro del que proviene el registro, con su nombre completo. Use estos nombres en include_dataset y exclude_dataset.
source: El nombre corto de la lista del registro, tal como está almacenado en el registro.
topics: Etiquetas de riesgo del registro, por ejemplo sanction o role.pep.
list_type: El tipo de lista: SANCTION, PEP, DEBARMENT, TAX_WARRANT, INSOLVENCY.
programme: El programa o la base legal que el publicador indica para la inclusión en la lista, cuando existe.
birth_date, nacionalidad, imo, alias: Los valores propios del registro, para revisarlos junto con su consulta.
merged_entity: El ID de la entidad combinada cuando esta parte se ha vinculado entre registros; consulte /api/entity/<merged_entity> para ver la vista combinada.
first_seen, last_seen: Cuándo recopilamos el registro por primera vez y cuándo se cargó por última vez desde su fuente.
url: La página del registro en este sitio.

Un puntaje mide parecido, no riesgo. Un puntaje de 1 significa que el registro se parece a su consulta; no indica que se trate de la misma parte ni qué tan grave es la inclusión en la lista. Revise topics, programme y el propio registro, y confirme con la lista oficial del publicador antes de actuar.

Resultados en detalle

Los resultados de coincidencias son breves a propósito. Para ver el registro completo, todas las inclusiones en listas y los demás registros que nombran a la misma parte, llame a la API de entidades con el id del resultado, o abra la página del registro desde url.

Linaje: de dónde proviene cada valor

Cada resultado indica su registro. Para consultar el historial valor por valor (qué fuente publicó cada nombre o fecha, y cuándo se vio por primera y última vez), use statements.csv en los archivos masivos. Por ahora la API no tiene un punto de acceso de declaraciones.

Cómo reducir las alertas falsas

Busque en el lugar correcto. Realice la verificación con la colección que exijan sus obligaciones y use topics y los filtros de registros para excluir las listas que no necesita.
Envíe más detalles. Una fecha de nacimiento, una nacionalidad o un número IMO permiten distinguir a personas homónimas; sin ellos, todas las que tienen el mismo nombre obtienen un puntaje similar.
Defina el umbral con criterio. Súbalo para reducir el ruido en nombres comunes y conserve las explicaciones junto con cada decisión. Consulte Ajuste.

Última actualización 2026-10-03