Paginación

Los endpoints de listado (GET /api/v1/dtes, GET /api/v1/bhe) devuelven un envelope consistente con los resultados y un cursor de continuación:

{
  "data": [
    {
      "id": "01957a91-0b50-7000-8000-000000000001",
      "folio": 1234,
      "tipo_dte": 33,
      "rut_emisor": "76123456-0",
      "rut_receptor": "11111111-1",
      "monto_total": 297500,
      "sii_status": "EPR",
      "fecha_emision": "2026-05-13",
      "created_at": "2026-05-13T14:32:48.000Z",
      "links": { "self": "/api/v1/dtes/01957a91-..." }
    }
  ],
  "next_cursor": null
}

Parámetros

Valores fuera de rango no fallan: limit se ajusta al rango y un sort/dir no reconocido cae al default.

curl "https://app.notta.cl/api/v1/dtes?limit=50&sort=folio&dir=asc" \
  -H "Authorization: Bearer ntt_cert_..."

Cursor (next_cursor)

La paginación está diseñada como cursor-based: el envelope incluye siempre el campo next_cursor. Cuando el cursoring esté activo, una respuesta que no agote el listado va a traer el token de continuación en next_cursor, que pasas en la siguiente request como ?cursor=<token>.

Próximos pasos

• Referencia API de DTEs — el detalle de cada endpoint de consulta, PDF y XML.
• Límites de tasa — cuánto puedes iterar antes de toparte con el 429.
• Catálogo de errores — los códigos que pueden devolver los listados.