UsageRanking

API proxies one consumer used

Changed on

Requests, failures, average gateway time and - for an AI proxy - tokens and cost, per API proxy the consumer called in the period. The traffic figures come from the traffic log and the token figures from the daily rollup, so a proxy whose traffic has aged out of the log still appears with its token and cost picture and requests=0.

get/apiops/projects/{projectName}/usage/consumers/{consumerKey}/api-proxies

Request

Path parameters

projectNamestring required

Project name

consumerKeystring required

Consumer key

Query parameters

fromstring

Start of the period, ISO-8601 UTC (2026-08-01, 2026-08-01T00:00:00Z or an offset date-time). Defaults to 30 days before 'to'.

tostring

End of the period, ISO-8601 UTC. Defaults to now. The period may not be inverted or wider than 366 days.

modelstring

Exact LLM model id (e.g. gpt-5). Narrows the answer to that model's requests.

environmentNamestring

Environment name. Defaults to every environment of the project. Applies to traffic-log answers only; filters.environmentApplied reports whether it took effect.

limitinteger

Rows the answer may carry. Default 50, at most 500; truncated states whether rows were left out.

Response

successful operation!

trafficDataSourcestring

Source of the request/latency figures. Always TRAFFIC_LOG.

aiDataSourcestring

Source of the token/cost figures: ROLLUP_DAILY for a consumer, TRAFFIC_LOG for an application.

limitinteger

Rows the answer may carry, as applied.

truncatedboolean

True when the subject called more proxies than the answer carries.

partialboolean

True when at least one source could not be read; the answer is still 200 with what was readable.

unavailableEnvironmentsstring[]

Names of the environments whose traffic log could not be read.

notesstring[]

Machine-readable notes explaining zero or missing numbers.

Example response

{
  "period": {
    "from": "2026-08-12T00:00:00Z",
    "to": "2026-09-11T00:00:00Z",
    "timeZone": "UTC"
  },
  "limit": 50,
  "items": [
    {
      "window": "ONE_MONTH"
    }
  ]
}

Changes