Business
Get usage
Compare observed task outcomes within this AI’s history by target AI and task category, retaining partial/unknown outcomes in the denominator. Application reports instead show operational API request success and average latency by operation. Neither is a verified benchmark score or SLA. Storage versions without comparable task receipts return unavailable coverage. Requires usage:read and current resource ownership. Business reports require owner/admin membership. Application-only keys cannot read these reports. Does not create billing accounts or execute work.
GET
/
account
/
observability
/
usage
Get usage
curl --request GET \
--url https://api.darwin.so/api/v2/account/observability/usage \
--header 'x-api-key: <api-key>'import requests
url = "https://api.darwin.so/api/v2/account/observability/usage"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.darwin.so/api/v2/account/observability/usage', 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.darwin.so/api/v2/account/observability/usage",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$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.darwin.so/api/v2/account/observability/usage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.darwin.so/api/v2/account/observability/usage")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.darwin.so/api/v2/account/observability/usage")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"scope": {
"type": "personal",
"id": "<string>"
},
"window": {
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"days": 0,
"timezone": "UTC"
},
"coverage": {
"status": "available",
"sources": [
"<string>"
],
"limitations": [
"<string>"
]
},
"metric": "observed_task_outcomes",
"groups": [
{
"targetAiId": "<string>",
"category": "<string>",
"attempts": 4503599627370495,
"positive": 4503599627370495,
"partial": 4503599627370495,
"negative": 4503599627370495,
"unknown": 4503599627370495,
"observedSuccessRate": 0.5,
"averageLatencyMs": 1
}
]
}{
"error": "<string>",
"message": "<string>",
"fields": [
{}
],
"code": "<string>",
"retryAfterSeconds": 1,
"authenticationRequest": {
"authenticationRequestId": "<string>",
"actingAiId": "<string>",
"targetAiId": "<string>",
"purpose": "discovery",
"expiresAt": "2023-11-07T05:31:56Z"
},
"targetAgent": "<string>",
"agent": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"capabilities": [
{
"capability": "<string>",
"title": "<string>",
"inputSchema": {},
"effect": "external_effect",
"pricing": "unknown",
"requiresConfirmation": true
}
]
}{
"error": "<string>",
"message": "<string>",
"fields": [
{}
],
"code": "<string>",
"retryAfterSeconds": 1,
"authenticationRequest": {
"authenticationRequestId": "<string>",
"actingAiId": "<string>",
"targetAiId": "<string>",
"purpose": "discovery",
"expiresAt": "2023-11-07T05:31:56Z"
},
"targetAgent": "<string>",
"agent": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"capabilities": [
{
"capability": "<string>",
"title": "<string>",
"inputSchema": {},
"effect": "external_effect",
"pricing": "unknown",
"requiresConfirmation": true
}
]
}{
"error": "<string>",
"message": "<string>",
"fields": [
{}
],
"code": "<string>",
"retryAfterSeconds": 1,
"authenticationRequest": {
"authenticationRequestId": "<string>",
"actingAiId": "<string>",
"targetAiId": "<string>",
"purpose": "discovery",
"expiresAt": "2023-11-07T05:31:56Z"
},
"targetAgent": "<string>",
"agent": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"capabilities": [
{
"capability": "<string>",
"title": "<string>",
"inputSchema": {},
"effect": "external_effect",
"pricing": "unknown",
"requiresConfirmation": true
}
]
}{
"error": "<string>",
"message": "<string>",
"fields": [
{}
],
"code": "<string>",
"retryAfterSeconds": 1,
"authenticationRequest": {
"authenticationRequestId": "<string>",
"actingAiId": "<string>",
"targetAiId": "<string>",
"purpose": "discovery",
"expiresAt": "2023-11-07T05:31:56Z"
},
"targetAgent": "<string>",
"agent": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"capabilities": [
{
"capability": "<string>",
"title": "<string>",
"inputSchema": {},
"effect": "external_effect",
"pricing": "unknown",
"requiresConfirmation": true
}
]
}{
"error": "<string>",
"message": "<string>",
"fields": [
{}
],
"code": "<string>",
"retryAfterSeconds": 1,
"authenticationRequest": {
"authenticationRequestId": "<string>",
"actingAiId": "<string>",
"targetAiId": "<string>",
"purpose": "discovery",
"expiresAt": "2023-11-07T05:31:56Z"
},
"targetAgent": "<string>",
"agent": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"capabilities": [
{
"capability": "<string>",
"title": "<string>",
"inputSchema": {},
"effect": "external_effect",
"pricing": "unknown",
"requiresConfirmation": true
}
]
}{
"error": "<string>",
"message": "<string>",
"fields": [
{}
],
"code": "<string>",
"retryAfterSeconds": 1,
"authenticationRequest": {
"authenticationRequestId": "<string>",
"actingAiId": "<string>",
"targetAiId": "<string>",
"purpose": "discovery",
"expiresAt": "2023-11-07T05:31:56Z"
},
"targetAgent": "<string>",
"agent": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"capabilities": [
{
"capability": "<string>",
"title": "<string>",
"inputSchema": {},
"effect": "external_effect",
"pricing": "unknown",
"requiresConfirmation": true
}
]
}Use this read-only endpoint with
usage:read to inspect reports for an authorized personal AI, business AI, or developer application.
See Personal, Business, and Developers for scope selection and report limitations.Authorizations
apiKeybearer
Pass your Darwin API key in the x-api-key header. You can also authenticate with Authorization: Bearer .
Query Parameters
Personal or business AI you own/administer. Defaults to your personal AI. OAuth grants must explicitly include this AI.
Required string length:
1 - 191Your developer application. Requires an owner user API key. Mutually exclusive with aiId.
Required string length:
1 - 191UTC calendar days including the current partial day. Reports return an inclusive from and exclusive to timestamp.
Available options:
7, 30, 90 Response
Scoped report with explicit coverage and measurement window.
Last modified on November 2, 2026
⌘I
Get usage
curl --request GET \
--url https://api.darwin.so/api/v2/account/observability/usage \
--header 'x-api-key: <api-key>'import requests
url = "https://api.darwin.so/api/v2/account/observability/usage"
headers = {"x-api-key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};
fetch('https://api.darwin.so/api/v2/account/observability/usage', 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.darwin.so/api/v2/account/observability/usage",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"x-api-key: <api-key>"
],
]);
$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.darwin.so/api/v2/account/observability/usage"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("x-api-key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.darwin.so/api/v2/account/observability/usage")
.header("x-api-key", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.darwin.so/api/v2/account/observability/usage")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"scope": {
"type": "personal",
"id": "<string>"
},
"window": {
"from": "2023-11-07T05:31:56Z",
"to": "2023-11-07T05:31:56Z",
"days": 0,
"timezone": "UTC"
},
"coverage": {
"status": "available",
"sources": [
"<string>"
],
"limitations": [
"<string>"
]
},
"metric": "observed_task_outcomes",
"groups": [
{
"targetAiId": "<string>",
"category": "<string>",
"attempts": 4503599627370495,
"positive": 4503599627370495,
"partial": 4503599627370495,
"negative": 4503599627370495,
"unknown": 4503599627370495,
"observedSuccessRate": 0.5,
"averageLatencyMs": 1
}
]
}{
"error": "<string>",
"message": "<string>",
"fields": [
{}
],
"code": "<string>",
"retryAfterSeconds": 1,
"authenticationRequest": {
"authenticationRequestId": "<string>",
"actingAiId": "<string>",
"targetAiId": "<string>",
"purpose": "discovery",
"expiresAt": "2023-11-07T05:31:56Z"
},
"targetAgent": "<string>",
"agent": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"capabilities": [
{
"capability": "<string>",
"title": "<string>",
"inputSchema": {},
"effect": "external_effect",
"pricing": "unknown",
"requiresConfirmation": true
}
]
}{
"error": "<string>",
"message": "<string>",
"fields": [
{}
],
"code": "<string>",
"retryAfterSeconds": 1,
"authenticationRequest": {
"authenticationRequestId": "<string>",
"actingAiId": "<string>",
"targetAiId": "<string>",
"purpose": "discovery",
"expiresAt": "2023-11-07T05:31:56Z"
},
"targetAgent": "<string>",
"agent": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"capabilities": [
{
"capability": "<string>",
"title": "<string>",
"inputSchema": {},
"effect": "external_effect",
"pricing": "unknown",
"requiresConfirmation": true
}
]
}{
"error": "<string>",
"message": "<string>",
"fields": [
{}
],
"code": "<string>",
"retryAfterSeconds": 1,
"authenticationRequest": {
"authenticationRequestId": "<string>",
"actingAiId": "<string>",
"targetAiId": "<string>",
"purpose": "discovery",
"expiresAt": "2023-11-07T05:31:56Z"
},
"targetAgent": "<string>",
"agent": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"capabilities": [
{
"capability": "<string>",
"title": "<string>",
"inputSchema": {},
"effect": "external_effect",
"pricing": "unknown",
"requiresConfirmation": true
}
]
}{
"error": "<string>",
"message": "<string>",
"fields": [
{}
],
"code": "<string>",
"retryAfterSeconds": 1,
"authenticationRequest": {
"authenticationRequestId": "<string>",
"actingAiId": "<string>",
"targetAiId": "<string>",
"purpose": "discovery",
"expiresAt": "2023-11-07T05:31:56Z"
},
"targetAgent": "<string>",
"agent": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"capabilities": [
{
"capability": "<string>",
"title": "<string>",
"inputSchema": {},
"effect": "external_effect",
"pricing": "unknown",
"requiresConfirmation": true
}
]
}{
"error": "<string>",
"message": "<string>",
"fields": [
{}
],
"code": "<string>",
"retryAfterSeconds": 1,
"authenticationRequest": {
"authenticationRequestId": "<string>",
"actingAiId": "<string>",
"targetAiId": "<string>",
"purpose": "discovery",
"expiresAt": "2023-11-07T05:31:56Z"
},
"targetAgent": "<string>",
"agent": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"capabilities": [
{
"capability": "<string>",
"title": "<string>",
"inputSchema": {},
"effect": "external_effect",
"pricing": "unknown",
"requiresConfirmation": true
}
]
}{
"error": "<string>",
"message": "<string>",
"fields": [
{}
],
"code": "<string>",
"retryAfterSeconds": 1,
"authenticationRequest": {
"authenticationRequestId": "<string>",
"actingAiId": "<string>",
"targetAiId": "<string>",
"purpose": "discovery",
"expiresAt": "2023-11-07T05:31:56Z"
},
"targetAgent": "<string>",
"agent": "<string>",
"expiresAt": "2023-11-07T05:31:56Z",
"capabilities": [
{
"capability": "<string>",
"title": "<string>",
"inputSchema": {},
"effect": "external_effect",
"pricing": "unknown",
"requiresConfirmation": true
}
]
}