# Usage API – Tiempo

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

Source: https://tiempo.one/docs/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

-   `period` (string)
    
    A month, YYYY-MM. Defaults to this month.
    

GET /v1/usage

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

200Response

```json
{
  "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

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

200Response

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

The machine-readable description is at [/openapi.json](https://tiempo.one/openapi.json). Try calls in [Swagger UI](https://tiempo.one/swagger-ui.html).[Tiempo home](https://tiempo.one/)[Dashboard](https://tiempo.one/app)