Referencia de la API

Dónde se crea la llave

Configuración → Integraciones, en un plan Business. La llave tiene la forma ik_live_ más 48 caracteres hexadecimales. Se muestra completa una sola vez. Inari guarda solo el SHA-256. En la lista queda un prefijo para reconocerla. Se puede revocar. Una llave pertenece a una empresa y no lee datos de otra.

Todas las llamadas llevan Authorization: Bearer ik_live_…. Sin el encabezado la respuesta es 401. Si la llave no tiene el alcance del endpoint, es 403.

Alcances

Listar facturas

GET /api/v1/invoices devuelve las facturas de la empresa, de la más nueva a la más vieja, con sus líneas. Parámetros opcionales: status (el estado tal como está guardado, por ejemplo aceptada), from y to sobre la fecha de emisión (YYYY-MM-DD), y limit (por defecto 50, máximo 200).

curl "https://app.inarihq.com/api/v1/invoices?status=aceptada&from=2026-01-01&limit=50" \
  -H "Authorization: Bearer ik_live_…"

Cada elemento trae id, numero, clientId, tipoComprobante, estado, fechaEmision, moneda, tipoCambio, subtotal, iva, total, lineas y createdAt. Los montos viajan como texto, no como número de punto flotante. No hay GET por id ni POST para crear.

Clientes

GET /api/v1/clients lista hasta 200, de la creación más reciente a la más antigua. No filtra por cédula ni por nombre: el recorte es el límite.

curl -X POST https://app.inarihq.com/api/v1/clients \
  -H "Authorization: Bearer ik_live_…" \
  -H "Content-Type: application/json" \
  -d '{"nombre":"Café del Volcán","identificacion":"3101123456","tipoCliente":"empresa"}'

El POST exige nombre, identificacion y tipoCliente (individual o empresa). Opcionales: nombreLegal, pais (si se omite, Costa Rica) y codigoActividad. Responde 201 con id, nombre e identificacion. No consulta el registro de Hacienda y no infiere el tipo de identificación de la Nota 4: eso lo hace la pantalla de clientes. Un alta por API dispara el webhook client.created si hay un endpoint suscrito.