> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Daily Consumption

> Return daily consumption for the current billing cycle

Requires an enterprise admin personal API key.

Returns daily ACU consumption data for your enterprise, broken down by date and organization.

## Timezone behavior

Billing cycles use **midnight PST (Pacific Standard Time)** as the day boundary, which corresponds to **08:00:00 UTC**. To match the consumption data shown in the Devin dashboard, you must pass timestamps with this timezone offset.

For example, to query consumption for a billing cycle from December 5, 2025 to January 5, 2026:

```bash theme={null}
curl "https://api.devin.ai/v2/enterprise/consumption/daily?start_date=2025-12-05T08:00:00Z&end_date=2026-01-05T08:00:00Z" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

If you pass dates without the `T08:00:00Z` suffix (e.g., `2025-12-05`), the API will use midnight UTC, which may result in slightly different consumption totals compared to the dashboard.

## Filtering by organization

When filtering by `org_ids`, the results will only include Devin session ACUs. ACUs consumed by Cascade and Terminal are omitted, as usage for these products is not tied to any organization.


## OpenAPI

````yaml /v2-openapi.yaml GET /v2/enterprise/consumption/daily
openapi: 3.1.0
info:
  description: Devin v2 API with Personal API Keys for Enterprise Admins
  title: Devin API v2
  version: 2.0.0
servers: []
security:
  - bearerAuth: []
paths:
  /v2/enterprise/consumption/daily:
    get:
      tags:
        - consumption
      summary: Daily Consumption Endpoint
      description: >-
        Return daily consumption for the current billing cycle.


        **Timezone behavior**: Billing cycles use midnight PST (Pacific Standard
        Time)

        as the day boundary, which corresponds to 08:00:00 UTC. To match the
        consumption

        data shown in the Devin dashboard, pass timestamps with this timezone
        offset

        (e.g., `2025-12-05T08:00:00Z` for December 5, 2025 PST).
      operationId: daily_consumption_endpoint_v2_enterprise_consumption_daily_get
      parameters:
        - in: query
          name: start_date
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            title: Start Date
        - in: query
          name: end_date
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            title: End Date
        - in: query
          name: start
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            title: Start
        - in: query
          name: end
          required: false
          schema:
            anyOf:
              - format: date-time
                type: string
              - type: 'null'
            title: End
        - in: query
          name: org_ids
          required: false
          schema:
            anyOf:
              - items:
                  type: string
                type: array
              - type: 'null'
            title: Org Ids
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ConsumptionResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
components:
  schemas:
    ConsumptionResponse:
      properties:
        consumption_by_date:
          additionalProperties:
            type: number
          propertyNames:
            format: date
          title: Consumption By Date
          type: object
        consumption_by_org_id:
          additionalProperties:
            type: number
          title: Consumption By Org Id
          type: object
        consumption_by_user:
          anyOf:
            - additionalProperties:
                type: number
              type: object
            - type: 'null'
          title: Consumption By User
        total_acus:
          title: Total Acus
          type: number
      required:
        - total_acus
        - consumption_by_date
        - consumption_by_org_id
      title: ConsumptionResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
  securitySchemes:
    bearerAuth:
      description: Personal API Key (apk_user_*) for Enterprise Admins only
      scheme: bearer
      type: http

````