provod.ai / docs
API

Get daily activity

Read daily model activity over the last 30 completed UTC days.

Last updated on

GET /v1/activity

Read daily model activity over the last 30 completed UTC days. Today is excluded.

Authentication

Authorization: Bearer <MANAGEMENT_API_KEY>: a management key bound to the workspace.

The credential determines the workspace. X-Org-Id is unsupported.

Query parameters

FieldTypeDescription
datestringYYYY-MM-DD; optional day within the window. Dates outside it return an empty list.
group_bystringworkspace; adds workspace_id to each row.
workspace_id, api_key_hash, user_id, external_userstring1–128 characters. Optional filters; do not expand access.

Response · 200

FieldTypeDescription
dataobject[]One row per UTC date and model.
data[].datestringYYYY-MM-DD.
data[].model, data[].model_permaslugstringPublic model identifier; the same value in both fields.
data[].requestsnumberTerminal request count.
data[].prompt_tokens, completion_tokens, reasoning_tokens, cached_tokensnumberRecorded token counters on each row.
data[].usagenumberActual charges in currency.
data[].usage_exactstringSame amount with eight decimal places.
data[].currencystringWorkspace billing currency.
data[].workspace_idstringOnly when group_by=workspace.
data[].provider_name, data[].endpoint_idstringCurrently unknown.
data[].byok_usage_inferencenumberAlways zero.

Spending is grouped by ledger posting time; request statistics by terminal recording time. Paid failures and disconnects contribute spending. Refunds do not reduce original charges. Use exact decimal strings and decimal arithmetic for reconciliation.

Response example

Identifiers and amounts in these examples are illustrative.

Request example

Load the key into a server environment variable. TypeScript uses Node.js fetch; Python uses only the standard library.

const response = await fetch("https://api.provod.ai/v1/activity?group_by=workspace", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.MANAGEMENT_API_KEY}`,
  },
});
if (!response.ok) throw new Error(`${response.status}: ${await response.text()}`);
console.log(await response.json());

Errors

HTTPErrorCause
401UnauthorizedMissing, invalid, disabled, revoked or expired key. The X-Org-Id header is also rejected.
403ForbiddenWrong key kind or insufficient workspace access.
400Bad RequestInvalid or unknown parameters.
429Too Many RequestsAnalytics rate limit exceeded: 2 per second, 30 per minute; service-wide limits also apply.

| 503 | Service Unavailable | Report rate-limit storage is temporarily unavailable. Retry later. |

Authentication error example:

{
  "error": {
    "code": "invalid_api_key",
    "message": "Invalid API key",
    "metadata": {}
  }
}

Operation error example:

{
  "statusCode": 429,
  "message": "ThrottlerException: Too Many Requests"
}

Next steps

On 429, honor the Retry-After header. Limits are scoped to the workspace for each operation.

On this page