Read the Organization's evaluation quota

GET /v1/usage/evaluation-quota

Answers the Organization's evaluation quota of the current UTC day (1.63.0; prompt-manager.md section 9.1): the limit in model tokens, 2,000,000 a day (a target) until the plans of slice 2.5 carry it, the tokens of the Usage events of the origin evaluation used so far in every environment, the tokens the queued and running runs and calibrations hold, and what remains. A request that would pass it is refused with 429 evaluation_quota_reached.

Request

Set VOCAL_API to the base URL of your API and VOCAL_API_KEY to an API key with the usage:read scope (Authentication and keys). Replace each placeholder, such as agt_... or <name>, with your own value.

curl "$VOCAL_API/v1/usage/evaluation-quota" \
  -H "Authorization: Bearer $VOCAL_API_KEY"

const response = await fetch(`${process.env.VOCAL_API}/v1/usage/evaluation-quota`, {
  headers: {
    Authorization: `Bearer ${process.env.VOCAL_API_KEY}`,
  },
});
console.log(response.status, await response.text());

import os

import requests

response = requests.get(
    f"{os.environ['VOCAL_API']}/v1/usage/evaluation-quota",
    headers={
        "Authorization": f"Bearer {os.environ['VOCAL_API_KEY']}",
    },
)
print(response.status_code, response.text)

Responses

Fields of the 200 answer

The shape is EvaluationQuota.