Skip to main content
GET
Get Session Daily Consumption
The consumption API is available only to accounts on the Enterprise plan. Teams and self-serve organizations receive a 403 response.

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.
This endpoint excludes Devin Review ACUs, and acus_by_product.review returns null. Devin Review usage does not belong to a session.

Permissions

Requires a service user or personal access token with the ViewOrgConsumption permission at the organization level, in an organization on the Enterprise plan.

Authorizations

Authorization
string
header
required

Service User credential (prefix: cog_)

Path Parameters

session_id
string
required

Session ID (prefix: devin-). Alias for devin_id used in consumption endpoints.

Example:

"devin-abc123def456"

org_id
string
required

Organization ID (prefix: org-)

Example:

"org-abc123def456"

Query Parameters

time_before
integer | null
time_after
integer | null

Response

Successful Response

consumption_by_date
ConsumptionByDateResponse · object[]
required
total_acus
number
required