Skip to main content
curl --request GET \
  --url https://api.baseten.co/v1/gateway/groups/abc123hash/usage \
  --header "Authorization: Api-Key $BASETEN_API_KEY"

{
  "customer_id": "cust_42",
  "usage": {
    "your-org/your-model": [
      {
        "type": "TOKEN",
        "unit": "DAY",
        "threshold": 10000000,
        "current_usage": 4231899,
        "reset_at": "2026-05-21T00:00:00Z"
      }
    ]
  }
}
Return current-window consumption for a single group, broken down by model. The response only includes models that have usage_limits configured — rate limits are not surfaced here. Use this endpoint to power per-customer dashboards or to check remaining quota before issuing a workload. This endpoint is the Frontier Gateway equivalent of the legacy per-API-key usage lookup: usage now hangs off the group, and every API key under the group reports against the same counters.

​
Authentication

​
Authorization
string
required
Workspace API key with management scope, passed as Authorization: Api-Key $BASETEN_API_KEY (or Bearer; both are accepted).

​
Path parameters

​
group_id
string
required
Internal Baseten ID of the group. Returned as id from Create a group and from List groups.

​
Response

​
customer_id
string
required
The group’s external identifier — the value you passed as metadata.external_entity_id when creating the group.
​
usage
object
required
Per-model usage entries, keyed by the model slug. Only models that have usage_limits configured on the group’s effective configuration appear here; a group with no configured usage limits returns an empty object.Each value is an array of usage entries, one per configured (type, unit) pair:
  • type (string): TOKEN or REQUEST.
  • unit (string): Window size for the limit. DAY is the only supported value.
  • threshold (integer): Configured quota for the window.
  • current_usage (integer or null): Total consumption in the current window. null until the first request lands.
  • reset_at (string or null): UTC timestamp when the current window resets. null until the first request lands.

​
Errors

StatusMeaning
403 ForbiddenThe group exists but isn’t in your workspace, or the caller doesn’t have management scope.
404 Not FoundNo group with this id in your workspace, or it has been deleted.
curl --request GET \
  --url https://api.baseten.co/v1/gateway/groups/abc123hash/usage \
  --header "Authorization: Api-Key $BASETEN_API_KEY"

{
  "customer_id": "cust_42",
  "usage": {
    "your-org/your-model": [
      {
        "type": "TOKEN",
        "unit": "DAY",
        "threshold": 10000000,
        "current_usage": 4231899,
        "reset_at": "2026-05-21T00:00:00Z"
      }
    ]
  }
}