Today's usage

Read today’s token totals, limits, and reset time.

GET /usage/today

Today's usage

cURL

curl --request GET \
  --url https://api.getmetacognition.com/usage/today

200

{
  "tokens_in_used": 123,
  "tokens_out_used": 123,
  "tokens_in_limit": 123,
  "tokens_out_limit": 123,
  "period": "<string>",
  "period_start": "<string>",
  "period_end": "<string>"
}

Returns today’s tokens_in and tokens_out, plus the limits that trigger 429. This request does not count against your quota, so you can poll it from dashboards or monitors.

Headers

Authorization: Bearer <access_token>

Response — 200

tokens_in_used · integer

Input tokens billed today.

tokens_out_used · integer

Output tokens billed today.

tokens_in_limit · integer

Daily ingress cap.

tokens_out_limit · integer

Daily egress cap.

period · string

Always "day_utc".

period_start · string

ISO 8601 timestamp at 00:00 UTC today.

period_end · string

ISO 8601 timestamp at 00:00 UTC tomorrow (when limits reset).

Example

cURL

curl -H "Authorization: Bearer $JWT" \
  https://api.getmetacognition.com/usage/today

Response

{
  "tokens_in_used": 12,
  "tokens_out_used": 27,
  "tokens_in_limit": 1000000,
  "tokens_out_limit": 5000000,
  "period": "day_utc",
  "period_start": "2026-05-08T00:00:00+00:00",
  "period_end": "2026-05-09T00:00:00+00:00"
}