Introducción

API en tiempo real para consulta y reporte de información crediticia en México, conforme a la LRSIC (Ley para Regular las Sociedades de Información Crediticia).

Trisenda es una nueva Sociedad de Información Crediticia (SIC) construida desde cero con arquitectura moderna: en lugar del intercambio mensual de archivos batch de los burós tradicionales, las instituciones se integran una vez a la API y reportan los eventos crediticios en tiempo real (máximo 24h).

Alcance del MVP (Pilar 1)

Este MVP cubre solo el Pilar 1 — Reporte Crediticio en Tiempo Real:

Ingesta de eventos crediticios vía API (originaciones, pagos, atrasos, etc.).
Expediente crediticio maestro único por persona.
Reporte de Crédito Estándar (anonimizado, para instituciones) y Especial (con acreedores, para el titular).
Validación y reconciliación programática (esquema, duplicados, identidad).
Bitácora de auditoría de cada lectura y escritura.

Fuera del MVP: Senda Score (Pilar 2), Tri App (Pilar 3) y el flujo de reclamaciones Art. 42-47.

URL base

Entorno	URL
Producción	`https://api.trisenda.com.mx/v1`
Demo (mock Postman)	`https://<id>.mock.pstmn.io/v1`

Los 8 endpoints

Endpoint	Para qué
`POST /v1/events`	Ingesta de eventos crediticios (el otorgante escribe)
`GET /v1/events/{event_id}`	Estado de un evento registrado
`GET /v1/credit-files/{curp}`	Expediente crediticio maestro (vista interna/admin)
`POST /v1/reports/standard`	Reporte Estándar anonimizado (institución consulta)
`POST /v1/reports/special/request`	Reporte Especial paso 1: envía OTP al titular
`POST /v1/reports/special/verify`	Reporte Especial paso 2: canjea OTP
`GET /v1/reconciliation/queue`	Eventos en `needs_review`
`GET /v1/audit`	Bitácora de auditoría de lecturas y escrituras

Identificación del titular

curp es obligatorio (identidad primaria). De forma opcional puedes enviar RFC, nombre estructurado, fecha de nacimiento, domicilio y empleador — esto cubre los datos del Cliente que exige el Circular 17/2014 de Banxico (Personas Físicas).

El detalle de cada endpoint (parámetros, ejemplos de petición/respuesta, errores) está en la sección API Reference.