Get Organization Usage

Get organization usage

curl --request GET \
  --url https://api-v2.requesty.ai/v1/manage/org/usage \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api-v2.requesty.ai/v1/manage/org/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-v2.requesty.ai/v1/manage/org/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 => [
    "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-v2.requesty.ai/v1/manage/org/usage"

	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-v2.requesty.ai/v1/manage/org/usage")

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

{
  "usage": {}
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

GET

manage

org

usage

Get organization usage

curl --request GET \
  --url https://api-v2.requesty.ai/v1/manage/org/usage \
  --header 'Authorization: Bearer <token>'

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

fetch('https://api-v2.requesty.ai/v1/manage/org/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-v2.requesty.ai/v1/manage/org/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 => [
    "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-v2.requesty.ai/v1/manage/org/usage"

	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-v2.requesty.ai/v1/manage/org/usage")

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

{
  "usage": {}
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

{
  "error": {
    "origin": "router",
    "message": "<string>"
  }
}

Get aggregated usage statistics for your entire organization within a date range. Supports aggregation by different time periods and optional grouping by user, member, API key, model, custom fields, or labels. Supported group_by fields: group_name, group_id, member_id, member_email, user_id, api_key_id, model_requested, model_used, provider_used, is_byok, origin_title, extra.<field_name>, api_key_label.<label_key>, and group_label.<label_key>.

Use api_key_label.<label_key> or group_label.<label_key> to break down spend by the labels you set on API keys or groups — for example group_by=api_key_label.team groups usage by each key’s team label. Rows whose key or group is missing the label are grouped under Unknown.

Authorizations

Authorization

string

header

required

API key for authentication

Query Parameters

start

string<date-time>

required

Start date in RFC3339 format (e.g., 2025-01-01T00:00:00Z). Required. The date range cannot exceed 100 days from start to end.

Example:

"2025-01-01T00:00:00Z"

end

string<date-time>

End date in RFC3339 format (e.g., 2025-01-31T23:59:59Z). Optional. Defaults to 24 hours from start if not specified. Must be after start date. The date range cannot exceed 100 days.

Example:

"2025-01-31T23:59:59Z"

resolution

enum<string>

default:day

Time resolution for aggregation

Available options:

hour,

day,

month

group_by

string[]

Fields to group by: group_name, group_id, member_id, member_email, user_id, api_key_id, model_requested, model_used, provider_used, is_byok, origin_title, extra.<field_name>, api_key_label.<label_key>, or group_label.<label_key>. Rows missing a requested label are grouped under "Unknown". Can be specified multiple times.

Response

Successfully retrieved usage data

usage

object

required

Map of period (string) to usage entry

Show child attributes

Last modified on August 4, 2026

API Keys

Groups

Group Members

Access Lists

Organization

Resources

Authorizations

Query Parameters

Response