Facturación

Consulta tu consumo facturable por API: partes confirmados y coste estimado del mes.

Consultar el consumo

GET/usage

Query

Campo	Tipo	Descripción
`month`	string	Mes AAAA-MM. Por defecto, el mes en curso (UTC).

curl

curl https://api.kinapi.es/api/v1/usage \
  -H "ocp-apim-subscription-key: TU_API_KEY"

200 OK

{
  "month": "2026-08",
  "partes": 128,
  "unitAmountCents": 50,
  "currency": "eur",
  "estimatedCents": 6400,
  "note": "Estimación sin IVA. La factura oficial (con IVA) la emite Stripe a fin de mes…",
  "byDay": { "2026-08-01": 4, "2026-08-02": 9 },
  "history": [
    { "month": "2026-07", "partes": 340, "estimatedCents": 17000 }
  ]
}

El campo partes cuenta reservas comunicadas, que es la unidad que se factura (0,50 € + IVA cada una): una reserva cuenta una vez tenga los huéspedes que tenga. Conserva ese nombre por compatibilidad con integraciones anteriores. estimatedCents es una estimación sin IVA; la factura oficial con IVA la emite Stripe a fin de mes. El entorno de pruebas no se factura nunca: con una clave kinapi_test_ este endpoint siempre devuelve cero.