Skip to main content
GET
/
billing
/
usages
/
acl
Get Acl Step Usage Endpoint
curl --request GET \
  --url https://api.contextual.ai/v1/billing/usages/acl \
  --header 'Authorization: Bearer <token>'
{
  "usages": [
    {
      "step_name": "<string>",
      "date": "<string>",
      "input_tokens": 123,
      "output_tokens": 123,
      "total_cost": 123
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
year
integer
required
Required range: x >= 2025
​
month
integer
required
Required range: 1 <= x <= 12
​
resource_id
string<uuid> | null

Response

Successful Response

Response containing daily usages of advance queries grouped by steps.

This API returns step-level breakdown of Agent Composer usage for visualization purposes. The costs in this response are already included in the ACL_COST entry from the daily_usages table and should not be double-counted.

​
usages
AgentComposerStepUsage · object[]
required

List of Agent Composer step usages aggregated by step and date