Vas a lograr entender qué es la API pública de Mozart y por dónde empezar a integrarla.

Qué es

La API pública de Mozart es una API HTTP sobre los datos de tu organización en la plataforma: carteras, deudores, deudas, llamadas, pagos, promesas de pago y campañas. Cubre lectura de todo lo anterior, escritura de pagos y carga de cartera, y webhooks para recibir eventos en tiempo real. Cada request se autentica con una clave de API propia de tu organización. Está pensada para equipos técnicos de bancos y financieras que ya operan su cartera en Mozart y necesitan traer esos datos a sus propios sistemas —un data warehouse, un CRM, un panel interno— sin depender de exportaciones manuales.

Qué podés leer hoy

  • GET /v1/me — quién es la clave que está llamando.
  • GET /v1/portfolios — las carteras de tu organización.
  • GET /v1/debtors — los deudores de esas carteras.
  • GET /v1/debts — las deudas de cada deudor.
  • GET /v1/calls — las llamadas de cobranza y su análisis post-llamada.
  • GET /v1/payments — los pagos registrados.
  • GET /v1/promises — las promesas de pago.
  • GET /v1/campaigns — las campañas de cobranza.
Todos los endpoints de lista devuelven { data, pagination } y aceptan cursor y limit; el detalle está en Paginación, errores y límites. La referencia completa, endpoint por endpoint, está en la pestaña Referencia.

Qué podés escribir hoy

Con una clave que tenga el scope write (ver Autenticación):
  • POST /v1/payments — registrar un pago, idempotente por externalId. Ver Pagos.
  • El flujo de tres pasos para cargar un CSV de deudores y deudas a una cartera existente. Ver Carga de cartera.

Eventos en tiempo real

Mozart también puede avisarte por webhook cuando pasa algo —una llamada termina, se registra una promesa o un pago— en vez de que tengas que pollear. Ver Webhooks.

Qué viene

Nuevas líneas de trabajo se publican en el Changelog a medida que avanzan.

Siguiente paso

Seguí Autenticación para obtener tu clave, y después Guía de inicio rápido para hacer tu primera llamada.