Get usage

Calls, billed units, misses, errors and spend for each UTC day of the range, by product, and for each route. A key with full access reads the whole organization’s usage, or one key’s with apiKeyId; any other key reads only its own. Free.

GET /v1/usage

Get usage

cURL

curl --request GET \
  --url https://api.outbound.dev/v1/usage \
  --header 'Authorization: Bearer <token>'

200

{
  "days": [
    {
      "day": "2026-11-14",
      "calls": 12,
      "billedUnits": 18,
      "misses": 1,
      "errors4xx": 1,
      "errors5xx": 0,
      "rateLimited": 0,
      "costUsd": "0.001800",
      "byProduct": [
        {
          "product": "search",
          "calls": 9,
          "costUsd": "0.001800"
        },
        {
          "product": "account",
          "calls": 3,
          "costUsd": "0.000000"
        }
      ]
    }
  ],
  "endpoints": [
    {
      "endpoint": "/v1/people/search",
      "product": "search",
      "calls": 4,
      "billedUnits": 10,
      "misses": 1,
      "errors4xx": 1,
      "errors5xx": 0,
      "costUsd": "0.001000",
      "p95LatencyMs": 5300
    }
  ]
}

Authorizations

Authorization · string · header · required

An API key from the console, starting ob_live_, sent as Authorization: Bearer <key>.

Query Parameters

from · string

The first UTC day, as YYYY-MM-DD. Without from and to, the last 30 days, today included.

Pattern: ^\d{4}-\d{2}-\d{2}$

to · string

The last UTC day, as YYYY-MM-DD. A range covers at most 90 days.

Pattern: ^\d{4}-\d{2}-\d{2}$

apiKeyId · string

Only this key's usage. A key without full access reads only its own.

Required string length: 24

Pattern: ^[0-9a-fA-F]+$

Response

200

application/json

Calls and spend for each UTC day in the range, and for each route.

days · object[] · required

Show child attributes

endpoints · object[] · required

Show child attributes