Guía de inicio rápido

Vas a lograr hacer tus primeras tres llamadas a la API pública de Mozart y entender la forma de cada respuesta. Necesitás una clave de API — si todavía no tenés una, seguí primero Autenticación.

Quién sos

Confirmá que tu clave funciona y a qué organización pertenece:

curl https://api.mozarth.com/v1/me \
  -H "Authorization: Bearer moz_live_8pQmZ3vT1nXsA7Kj4LhWdRc6YfBg2EtNu5oPxCz9-Ab"

{
  "data": {
    "organization": {
      "id": "01J9XPQZ3VYB1KZR6E9X6H9T5M",
      "name": "Banco Ejemplo S.A.",
      "status": "active"
    },
    "apiKey": {
      "id": "01J9XPRA1C7GQF3YV6M2N8T4KX",
      "name": "Integración Data Warehouse",
      "keyPrefix": "moz_live_8pQ",
      "scopes": ["read"],
      "expiresAt": null
    },
    "portfolioCount": 2
  }
}

portfolioCount es cuántas carteras activas ve esta clave — el alcance real de todo lo que sigue.

Tus carteras

curl https://api.mozarth.com/v1/portfolios \
  -H "Authorization: Bearer moz_live_8pQmZ3vT1nXsA7Kj4LhWdRc6YfBg2EtNu5oPxCz9-Ab"

{
  "data": [
    {
      "id": "01J9XPS0N4H8D2M7Q9V3K5T1WX",
      "organizationId": "01J9XPQZ3VYB1KZR6E9X6H9T5M",
      "status": "active",
      "identityName": "Cartera Tarjetas 2025",
      "identityDescription": "Cartera de tarjetas de crédito en mora temprana",
      "identityDebtType": "default",
      "identityRegion": "south_america",
      "identityTimezone": "America/Montevideo",
      "identityCurrency": ["UYU"],
      "operatingInfoMaxChannels": 8,
      "operatingInfoLastActivity": "2026-08-20T14:32:00Z",
      "compliancePiiRedactionEnabled": true,
      "createdAt": "2026-03-01T12:00:00.000Z",
      "updatedAt": "2026-08-20T14:32:00.000Z"
    }
  ],
  "pagination": {
    "nextCursor": null,
    "hasMore": false,
    "limit": 50
  }
}

Guardate el id de la cartera que te interesa — lo vas a usar para filtrar deudores, deudas, llamadas, pagos y promesas por portfolioId.

Algunos deudores

curl "https://api.mozarth.com/v1/debtors?limit=5" \
  -H "Authorization: Bearer moz_live_8pQmZ3vT1nXsA7Kj4LhWdRc6YfBg2EtNu5oPxCz9-Ab"

La respuesta trae hasta 5 objetos (por el limit); acá se muestra uno solo para no repetir la misma forma:

{
  "data": [
    {
      "id": "01J9XPS8K2M4N6Q8R1T3V5X7YZ",
      "portfolioId": "01J9XPS0N4H8D2M7Q9V3K5T1WX",
      "status": "active",
      "priority": "medium",
      "identityFirstName": "Lucía",
      "identityLastName": "Fernández",
      "identityEntityType": "individual",
      "identityDocumentType": "ci",
      "identityDocumentMasked": "***5678",
      "contactInfoContactName": null,
      "contactInfoPhoneNumbers": [
        { "phone": "+59899123456", "primary": true, "verified": true, "type": "mobile" }
      ],
      "contactInfoEmails": [
        { "address": "lucia.fernandez@ejemplo.com", "primary": true, "verified": false, "type": "personal" }
      ],
      "contactInfoAddressStreet": "Av. Ejemplo 1234",
      "contactInfoAddressCity": "Montevideo",
      "contactInfoAddressState": "Montevideo",
      "contactInfoAddressCountry": "UY",
      "contactInfoAddressPostalCode": "11200",
      "complianceOptOut": false,
      "complianceConsentToCall": true,
      "complianceConsentToWhatsapp": true,
      "complianceConsentToEmail": true,
      "complianceConsentToSms": null,
      "operatingInfoDoNotContact": false,
      "operatingInfoBlockReason": null,
      "createdAt": "2026-04-10T09:15:00.000Z",
      "updatedAt": "2026-08-18T11:02:00.000Z"
    }
  ],
  "pagination": {
    "nextCursor": "eyJpZCI6IjAxSjlYUFM4SzJNNE42UThSMVQzVjVYN1laIn0",
    "hasMore": true,
    "limit": 5
  }
}

pagination.hasMore: true te dice que hay más deudores; pedí la próxima página mandando pagination.nextCursor como el parámetro cursor del siguiente request. El detalle está en Paginación, errores y límites.

El mismo flujo en Node y Python

const API_KEY = process.env.MOZART_API_KEY;
const BASE_URL = 'https://api.mozarth.com/v1';

async function mozartGet(path) {
  const response = await fetch(`${BASE_URL}${path}`, {
    headers: { Authorization: `Bearer ${API_KEY}` },
  });

  const body = await response.json();
  if (!response.ok) {
    throw new Error(`${body.error.code}: ${body.error.message}`);
  }
  return body.data;
}

const me = await mozartGet('/me');
const portfolios = await mozartGet('/portfolios');
const debtors = await mozartGet('/debtors?limit=5');

import os
import requests

API_KEY = os.environ["MOZART_API_KEY"]
BASE_URL = "https://api.mozarth.com/v1"


def mozart_get(path: str):
    response = requests.get(
        f"{BASE_URL}{path}",
        headers={"Authorization": f"Bearer {API_KEY}"},
    )
    body = response.json()
    if not response.ok:
        raise RuntimeError(f"{body['error']['code']}: {body['error']['message']}")
    return body["data"]


me = mozart_get("/me")
portfolios = mozart_get("/portfolios")
debtors = mozart_get("/debtors?limit=5")

Siguiente paso

Leé Conceptos para entender cómo se relacionan los recursos entre sí, o andá directo a la pestaña Referencia para el detalle de cada endpoint.

Empezar

Guías

Plataforma

Changelog

Guía de inicio rápido

El mismo flujo en Node y Python

Siguiente paso

​El mismo flujo en Node y Python

​Siguiente paso

El mismo flujo en Node y Python

Siguiente paso