Búsqueda (Person Search)

Resuelve un sujeto combinando todas las fuentes que declara el modelo. Si en cambio querés preguntarle a una fuente concreta, mirá Fuentes.

POSTProbar la búsqueda→

El request

{
  "model": "PERSON_STANDARD",
  "entityType": "NATURAL_PERSON",
  "keys": { "cuit": "20111111112" }
}

Campo	Req.	Descripción
model	sí	Search Model del producto: PERSON_STANDARD o PERSON_ADVANCED. Ver Modelos.
keys	sí	Claves de búsqueda. Al menos una es obligatoria.
entityType	no	Hint de clase (NATURAL_PERSON / LEGAL_ENTITY). Si se omite, el motor la resuelve.

Claves (keys)

Clave	Ejemplo (sintético)	Notas
cuit	20111111112	CUIT/CUIL/CDI (11 dígitos). La clave más precisa.
dni	11111111	Documento.
name	Juan Ejemplo	Nombre o razón social (resolución por similitud).
birthDate	1980-01-01	Fecha de nacimiento (ISO YYYY-MM-DD).

Podés combinar varias claves para desambiguar. Si no enviás ninguna, la API responde 400.

La respuesta

{
  "queryId": "dq_...",
  "resolvedEntityType": "NATURAL_PERSON",
  "subjects": [
    {
      "resolvedEntityType": "NATURAL_PERSON",
      "entityRef": "ent_...",
      "identity": { "identifiers": [ ], "names": [ ] },
      "score": 98.5,
      "payloads": [ ]
    }
  ],
  "partial": false,
  "cost": { "amount": 1.0, "currency": "USD" },
  "correlationId": "..."
}

Campo	Significado
queryId	Identificador de la consulta.
resolvedEntityType	Clase resuelta cuando hay un sujeto dominante.
subjects[]	Sujetos resueltos y rankeados (mayor score primero).
subjects[].identity	Identidad canónica: identifiers y names.
subjects[].score	Puntaje de match (0..100).
subjects[].payloads[]	Dimensiones por dominio (ver Payloads).
partial	true si alguna fuente ejecutada falló o expiró (no por exclusión de scope).
cost	Precio comercial de la consulta, o null si no facturable.
correlationId	Correlación de la consulta (también en la cabecera x-correlation-id).

Parcialidad

partial: true indica que el resultado es utilizable pero incompleto porque una fuente que se ejecutó falló o se pasó de tiempo. Las fuentes excluidas por permisos (p.ej. ARCA sin provider:arca) no marcan partial: simplemente no aparecen.

Ver también: Modelos · Payloads por dominio · Fuentes · Errores.