Daily cost-orphaned usage metrics

GET

/api/v1/usage/metrics/daily

const url = 'https://example.com/api/v1/usage/metrics/daily';
const options = {method: 'GET'};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://example.com/api/v1/usage/metrics/daily

Total daily quantity per service, tier, metric, and unit, for the default tenant. These are the cost-orphaned usage metrics the AI-vendor connectors fetch but that carry no money on the vendor’s cost report (Anthropic priority/flex-tier tokens and web-search request counts; standard/batch usage keys no cost row referenced; OpenAI recognized-but-unpriced line items). They live OUTSIDE the FOCUS cost dataset, so they never appear in the daily-cost or daily-token views and never contribute to any cost or token total. Ordering is deterministic: day ascending, then serviceName, serviceTier, metricName, unit. Quantities are exact decimal strings — never floats. serviceTier is “” when the vendor has no tier concept.

Parameters

Query Parameters

start

string format: date

Inclusive first calendar day (UTC) to include. Defaults to the full range of stored data.

end

string format: date

Inclusive last calendar day (UTC) to include. Defaults to the full range of stored data.

Responses

200

Daily usage metrics grouped by service, tier, metric, and unit for the requested period, day-ascending.

application/json

Array<object>

object

date

required

The UTC calendar day.

string format: date

serviceName

required

Service or model identity.

string

serviceTier

required

Vendor service tier, or “” when the vendor has no tier concept.

string

metricName

required

Frozen metric identifier (a token_type, “web_search_requests”, or an opaque line item).

string

unit

required

Frozen unit vocabulary: “Tokens”, “Requests”, or “Unknown”.

string

quantity

required

Total quantity for the day/service/tier/metric/unit, as an exact decimal string — never a float.

string

Example

[
  {
    "date": "2026-05-01",
    "serviceName": "claude-opus-4-6",
    "serviceTier": "priority",
    "metricName": "uncached_input_tokens",
    "unit": "Tokens",
    "quantity": "999"
  }
]

400

Invalid start or end date.

text/plain

string