API de Consulta

Consulta verificaciones por numero de documento, metadata, ID o fecha.

Autenticacion

Usa tu webhook_secret como Bearer token:

Authorization: Bearer TR_WHS_xxx

Todas las consultas estan scoped a tu cuenta — no puedes ver verificaciones de otros clientes.

GET /api/v1/public/kyc/verifications

Parametros

Parametro	Tipo	Descripcion
q	string	Busca en tres lugares: el verification_id, la metadata que enviaste en el widget, y los datos extraidos del documento por OCR (nombre, numero de documento, etc)
status	string	Filtra por estado: pending, processing, approved, rejected
from	date	Fecha desde (YYYY-MM-DD)
to	date	Fecha hasta (YYYY-MM-DD)
limit	int	Tamano de pagina (default 20, max 100)
offset	int	Offset de paginacion (default 0)

Como funciona la busqueda (q)

El parametro q busca simultaneamente en:

1. ID de verificacion — el UUID que Trusty genera al iniciar (ej: 601e510f-b0c4-...)
2. Metadata — el JSON que tu enviaste en el widget (ej: {"userId":"123"}). Busca userId encontrara esa verificacion
3. Datos del documento (OCR) — los datos que la IA extrajo del documento: nombre completo, numero de documento, fecha de nacimiento, etc

Es una busqueda parcial (LIKE). q=60518799A encuentra cualquier verificacion donde el numero de documento extraido contenga ese texto.

Ejemplo: buscar por numero de documento

curl "https://trusty-api.trusty.sh/api/v1/public/kyc/verifications?q=60518799A" \
  -H "Authorization: Bearer TR_WHS_xxx"

Ejemplo: buscar por userId (metadata)

curl "https://trusty-api.trusty.sh/api/v1/public/kyc/verifications?q=user123" \
  -H "Authorization: Bearer TR_WHS_xxx"

Ejemplo: filtrar por estado y fecha

curl "https://trusty-api.trusty.sh/api/v1/public/kyc/verifications?status=approved&from=2026-07-01&to=2026-07-31&limit=10" \
  -H "Authorization: Bearer TR_WHS_xxx"

Response 200

{
  "items": [
    {
      "id": "601e510f-b0c4-4f6d-a8a2-132fb9b40cf3",
      "status": "approved",
      "country_code": "ES",
      "city": "Madrid",
      "failure_reason": null,
      "full_name": "GUILLERMO DANIEL CANELON LOVERA",
      "document_number": "60518799A",
      "metadata": { "userId": "123" },
      "created_at": "2026-07-24 02:56:48",
      "updated_at": "2026-07-24 03:17:05"
    }
  ],
  "total": 57,
  "limit": 20,
  "offset": 0
}

Campos de la respuesta

Campo	Descripcion
id	UUID de la verificacion
status	Estado actual: pending, processing, approved, rejected
country_code	Pais desde donde se realizo (codigo ISO 2 letras)
city	Ciudad desde donde se realizo
failure_reason	Si fue rechazada, los motivos separados por coma
full_name	Nombre completo extraido del documento por OCR
document_number	Numero de documento extraido por OCR
metadata	El JSON que tu enviaste en el widget, sin modificar
created_at	Fecha de creacion
updated_at	Ultima actualizacion

Casos de uso

• Buscar por userId: ?q=user123 — busca en la metadata que enviaste
• Buscar por DNI: ?q=60518799A — busca en los datos extraidos del documento
• Verificar duplicados: busca por numero de documento para ver si ya fue verificado antes
• Auditar por fecha: ?from=2026-07-01&to=2026-07-31

Errores

Status	Error	Descripcion
401	unauthorized	Token invalido o ausente