Daily Consumption

Daily Consumption Endpoint

curl --request GET \
  --url https://api.devin.ai/v2/enterprise/consumption/daily \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.devin.ai/v2/enterprise/consumption/daily', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.devin.ai/v2/enterprise/consumption/daily",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.devin.ai/v2/enterprise/consumption/daily"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.devin.ai/v2/enterprise/consumption/daily")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "consumption_by_date": {},
  "consumption_by_org_id": {},
  "total_acus": 123,
  "consumption_by_user": {}
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

GET

enterprise

consumption

daily

Daily Consumption Endpoint

curl --request GET \
  --url https://api.devin.ai/v2/enterprise/consumption/daily \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.devin.ai/v2/enterprise/consumption/daily', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.devin.ai/v2/enterprise/consumption/daily",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.devin.ai/v2/enterprise/consumption/daily"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.devin.ai/v2/enterprise/consumption/daily")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "consumption_by_date": {},
  "consumption_by_org_id": {},
  "total_acus": 123,
  "consumption_by_user": {}
}

{
  "detail": [
    {
      "loc": [
        "<string>"
      ],
      "msg": "<string>",
      "type": "<string>"
    }
  ]
}

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.

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:

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 include all ACUs attributed to the specified organizations: Devin session ACUs as well as Devin Desktop and Devin CLI ACUs, which are attributed to each user’s primary billing organization. See Local Agent Controls for how a user’s primary billing organization is resolved.

Authorizations

Authorization

string

header

required

Personal API Key (apk_user_*) for Enterprise Admins only

Query Parameters

start_date

string<date-time> | null

end_date

string<date-time> | null

start

string<date-time> | null

end

string<date-time> | null

org_ids

string[] | null

Response

Successful Response

consumption_by_date

Consumption By Date · object

required

Show child attributes

consumption_by_org_id

Consumption By Org Id · object

required

Show child attributes

total_acus

number

required

consumption_by_user

Consumption By User · object | null

Show child attributes

Getting Started

Concepts

Agent Lifecycle

Context Management

Environment Management

Automation

Integrations

Analytics

Observability

Devin for Security

Infrastructure

Identity & Access

Configuration

Legacy API v1

Legacy API v2

Timezone behavior

Filtering by organization

Authorizations

Query Parameters

Response

​Timezone behavior

​Filtering by organization

Authorizations

Query Parameters

Response

Timezone behavior

Filtering by organization