API reference

Usage

Bookings counted towards your bill, per month and per business. Platform-level.

Get usage

GET/v1/usage

Bookings counted this month (or period=YYYY-MM), the free allowance, and what’s billable, per business.

Query parameters

periodstring
A month, YYYY-MM. Defaults to this month.

GET /v1/usage

curl "https://api.tiempo.one/v1/usage?period=2026-10" \
  -H "Authorization: Bearer tpt_4qZ8m1VwXc0L…"

200Response

{
  "object": "usage",
  "livemode": true,
  "period": "2026-10",
  "status": "open",
  "invoiced": true,
  "bookings": 1240,
  "free_allowance": 1000,
  "free_remaining": 0,
  "billable_bookings": 240,
  "unit_amount": 2,
  "currency": "gbp",
  "amount": 480,
  "accounts": [
    {
      "account": "acct_01m42yt93ayvyrwr3yczhv6yhw",
      "name": "Soho Hair",
      "bookings": 812
    }
  ]
}

List statements

GET/v1/usage/statements

Closed months, frozen as they were billed.

GET /v1/usage/statements

curl "https://api.tiempo.one/v1/usage/statements" \
  -H "Authorization: Bearer tpt_4qZ8m1VwXc0L…"

200Response

{
  "object": "list",
  "data": [],
  "has_more": false
}