Skip to main content
GET
Get Service User Daily Consumption
The consumption API is available only to accounts on the Enterprise plan. Teams and self-serve organizations receive a 403 response; there is no per-account toggle for support to enable.

Product-Level Breakdown

Each date entry in the response includes an acus_by_product object that breaks down the total ACU consumption into its product components: devin, automation, cascade, terminal, and review (Devin Review). This allows you to see how consumption is distributed across products for each day. When product-level data is not available for devin, cascade, or terminal, its value defaults to 0.0. automation and review are null when their product-specific consumption data is not available.
  • devin: sessions started by a person or a service user, including code-scan and on-call sessions.
  • automation: sessions and code steps run by automations. Before this field existed, that usage was reported under devin.
The results include all ACUs of the service user, not only its sessions. This includes the Devin Review ACUs of the service user, which also appear in acus_by_product.review.

Permissions

Requires a service user or personal access token with the ViewAccountConsumption permission at the enterprise level.

Authorizations

Authorization
string
header
required

Service User credential (prefix: cog_)

Path Parameters

service_user_id
string
required

Service user ID (prefix: service-user-)

Example:

"service-user-abc123def456"

Query Parameters

time_before
integer | null
time_after
integer | null

Response

Successful Response

consumption_by_date
ConsumptionByDateResponse · object[]
required
total_acus
number
required