Get Batch Organization Token Usage | Captain API Documentation

Get total token usage for multiple organizations in a single request.

This batch endpoint is optimized for fetching token usage across multiple organizations simultaneously, reducing the number of API calls needed.

Authentication: Requires authenticated user via Auth0/Bearer token

Headers:

Authorization: Bearer {auth_token} - User authentication token

Request Body:

organization_ids: Array of organization UUIDs

Returns:

Array of token usage data for each organization

Get total token usage for multiple organizations in a single request. This batch endpoint is optimized for fetching token usage across multiple organizations simultaneously, reducing the number of API calls needed. Authentication: Requires authenticated user via Auth0/Bearer token Headers: - Authorization: Bearer {auth_token} - User authentication token Request Body: - organization_ids: Array of organization UUIDs Returns: - Array of token usage data for each organization

Headers

AuthorizationstringRequired

User authentication token

Request

This endpoint expects an object.

organization_idslist of stringsRequired

Response

Successful Response

resultslist of objects or null

1	import requests
2
3	url = "https://api.runcaptain.com/api/organizations/batch-tokens"
4
5	payload = ""
6	headers = {
7	"Authorization": "Bearer YOUR_AUTH_TOKEN",
8	"Content-Type": "application/x-www-form-urlencoded"
9	}
10
11	response = requests.post(url, data=payload, headers=headers)
12
13	print(response.json())

1	{
2	"results": [
3	{
4	"organization_id": "org_abc123",
5	"total_tokens": 5000000
6	},
7	{
8	"organization_id": "org_xyz789",
9	"total_tokens": 2500000
10	},
11	{
12	"organization_id": "org_def456",
13	"total_tokens": 1000000
14	}
15	]
16	}

Headers

Request

Response

Errors