API v1 — Overview

La API de InformeLegal expone cuatro superficies sobre una misma plataforma. No son productos separados: comparten API Key, scopes, formato de error, límites y facturación, y se documentan y prueban en un solo lugar.

Superficie	Para qué	Endpoint
Person Search	Resolver una persona física o jurídica combinando fuentes	POST /api/v1/person-search/search
Fuentes	Consultar una fuente puntual, o listar el catálogo	POST /api/v1/sources/{source}/query · GET /api/v1/sources
Email Validation	Validar un email con veredicto tri-estado	POST /api/v1/utils/email/validate
Phone Validation	Normalizar y enriquecer un teléfono en 4 niveles	POST /api/v1/utils/phone/validate

Probar sin salir de la doc

Cada página de API tiene arriba un botón Probar… que abre el playground directamente en esa operación, con el documento ya seleccionado. La API Key la pegás vos ahí.

En una línea

POST /api/v1/person-search/search
Authorization: Bearer ilk_...
Content-Type: application/json

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

POST /api/v1/sources/igj/query
Authorization: Bearer ilk_...
Content-Type: application/json

{ "keys": { "cuit": "30111111119" } }

Conceptos comunes

Valen para toda la API, no sólo para la búsqueda:

• Claves (keys): cuit, dni, name, birthDate. Al menos una es obligatoria en los endpoints de resolución.
• Sujetos (subjects): resultados resueltos y rankeados, cada uno con identity, score y payloads.
• Payloads: el conocimiento propio de cada fuente, sin deformar, identificado por schemaRef + version (p.ej. golden_record.person.v1, arca.padron.v1). El mismo payload llega por Person Search y por la consulta directa a la fuente.
• Scopes: alcances aditivos (ALL_OF) de tu API Key. Determinan qué modelos, fuentes y niveles podés usar.
• partial: el resultado es utilizable pero incompleto porque una fuente ejecutada falló o expiró. Una fuente excluida por permisos no marca parcialidad.

Propios de Person Search

• Modelo (model): qué conocimiento se incluye — PERSON_STANDARD o PERSON_ADVANCED.
• entityType (opcional): hint de clase; si se omite, el motor la resuelve.

Próximos pasos

• Getting Started — tu primer request en cualquiera de las superficies.
• Autenticación y scopes — API Keys y alcances de toda la API.
• API Reference + Playground — probá las cuatro superficies en vivo.

Todos los ejemplos usan datos sintéticos. No uses datos personales reales en el playground.