Billing

Read your billable usage over the API: confirmed reports and the estimated cost for the month.

Read your usage

GET/usage

Query

Field	Type	Description
`month`	string	Month as YYYY-MM. Defaults to the current month (UTC).

curl

curl https://api.kinapi.es/api/v1/usage \
  -H "ocp-apim-subscription-key: YOUR_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 }
  ]
}

The partes field counts bookings filed, which is the billing unit (€0.50 + VAT each): a booking counts once, however many guests it has. It keeps that name for compatibility with earlier integrations. estimatedCents is an estimate excluding VAT; the official invoice with VAT is issued by Stripe at the end of the month. Test mode is never billed: with a kinapi_test_ key this endpoint always returns zero.