Get usage

GET/v1/usageNeeds an API key

Summarise your organization's calls over the last days UTC days, today included.

days is 7, 30 or 90. Calls made by every key of the organization count, and so do those made from the console.

Query parameters

daysinteger· default 30

How many UTC days to cover, today included.

7

30

90

Response

Your workspace's calls over the window. Your organization's calls over a window of days, with money as decimal strings in USD. Days are UTC calendar days. The window is today (UTC) and the days before it, so its last day is still filling; totals.previous covers the same number of whole days immediately before the window. A call counts on the day it was created. daily has one entry per day of the window, oldest first, including days with no calls. by_tool and by_api_key list the most charged first, then the most called, and are capped.

totalsobject

The window's totals.

totals.callsinteger

Calls made.

totals.succeededinteger

Calls that succeeded.

totals.failedinteger

Calls that failed.

totals.pendinginteger

Calls still running.

totals.charged_usdstring

What the calls cost you.

totals.previousobject

The same totals for the window of equal length just before this one.

totals.previous.callsinteger

Calls made.

totals.previous.succeededinteger

Calls that succeeded.

totals.previous.failedinteger

Calls that failed.

totals.previous.pendinginteger

Calls still running.

totals.previous.charged_usdstring

What the calls cost you.

dailyarray of object

One entry per day of the window, oldest first.

daily.datestring

The UTC day.

Format date.

daily.callsinteger

Calls made.

daily.succeededinteger

Calls that succeeded.

daily.failedinteger

Calls that failed.

daily.charged_usdstring

What the calls cost you.

by_toolarray of object

The window's calls by tool, most charged first.

by_tool.toolstring

The tool called.

by_tool.callsinteger

Calls made.

by_tool.succeededinteger

Calls that succeeded.

by_tool.failedinteger

Calls that failed.

by_tool.charged_usdstring

What the calls cost you.

by_api_keyarray of object

The window's calls by API key, most charged first.

by_api_key.api_keyobject· nullable

Null for calls made without a key, such as from the console's playground.

by_api_key.api_key.idstring

The API key's ID.

by_api_key.api_key.labelstring

The API key's label.

by_api_key.callsinteger

Calls made.

by_api_key.charged_usdstring

What the calls cost you.

400Refused request body

The request was refused.

401INVALID_AUTH_TOKENRefused request body

The API key is missing, wrong or revoked.

422VALIDATIONInvalid request body

The request is not valid.

429RATE_LIMITEDRefused request body

Too many requests with this API key.

Retry-After: Seconds until the limit resets.

curl "https://api.voxoria.ai/v1/usage?days=30" \
  -H "Authorization: Bearer $VOXORIA_API_KEY"

import os

import httpx

response = httpx.get(
    "https://api.voxoria.ai/v1/usage",
    params={"days": 30},
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/usage?days=30", {
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
  },
});
console.log(await response.json());

200 OKResponseapplication/json

{
  "totals": {
    "calls": 128,
    "succeeded": 125,
    "failed": 2,
    "pending": 1,
    "charged_usd": "2.6750",
    "previous": {
      "calls": 96,
      "succeeded": 94,
      "failed": 2,
      "pending": 0,
      "charged_usd": "2.0116"
    }
  },
  "daily": [
    {
      "date": "2026-01-05",
      "calls": 6,
      "succeeded": 6,
      "failed": 0,
      "charged_usd": "0.1284"
    }
  ],
  "by_tool": [
    {
      "tool": "google.serp.organic",
      "calls": 128,
      "succeeded": 125,
      "failed": 2,
      "charged_usd": "2.6750"
    }
  ],
  "by_api_key": [
    {
      "api_key": {
        "id": "ak_6pW2rN9tK4xB7mQ3vL8cYd",
        "label": "production"
      },
      "calls": 128,
      "charged_usd": "2.6750"
    }
  ]
}