---
title: "Read the usage history"
description: "Sends and AI actions per day, and what pay as you go extras cost per month."
url: "https://openemail.uk/docs/api/billing/usage"
area: "API"
category: "Mailbox"
---

# Read the usage history

Sends and AI actions per day, and what pay as you go extras cost per month.

`GET /billing/usage`

## GET /billing/usage

Sends and AI actions per day, and what pay as you go extras cost per month.

## Example

Needs `billing:read`. `days` goes back 1 to 3,660 days, 30 by default, and `all` goes back to the day the workspace was made. `aiExtra` counts the AI actions past the daily allowance, which pay as you go billed.

**curl**

```
curl "$OE/billing/usage?days=7" -H "$AUTH"
```

**Response**

```
{
  "object": "usage_history",
  "days": [
    { "day": "2026-10-02", "aiActions": 14, "aiExtra": 0, "sends": 2210 },
    { "day": "2026-10-03", "aiActions": 9, "aiExtra": 0, "sends": 1870 }
  ],
  "months": [
    {
      "month": "2026-09",
      "extraSends": 3000,
      "extraAiActions": 0,
      "sendCents": 120,
      "aiCents": 0,
      "cents": 120
    }
  ],
  "dailyAiActions": 150,
  "monthlySends": 200000
}
```

> Only the owner of the workspace reaches billing: an API key, or an access token the owner connected with every address. A member’s token is a 403 `owner_only`, and a key or token limited to particular addresses or domains is a 422 `capability_unsupported`.

## Reference

- [`GET /billing/usage`](https://openemail.uk/docs/api/reference/billing#get-billing-usage): full reference