cURL
curl "https://api.platform.pearlresearch.ai/api/v1/key" \
-H "Authorization: Bearer $PEARL_API_KEY"import os
import requests
response = requests.get(
"https://api.platform.pearlresearch.ai/api/v1/key",
headers={"Authorization": f"Bearer {os.environ['PEARL_API_KEY']}"},
)
response.raise_for_status()
key = response.json()["data"]
print(key["label"], key["limit_remaining"])
const response = await fetch("https://api.platform.pearlresearch.ai/api/v1/key", {
headers: {Authorization: `Bearer ${process.env.PEARL_API_KEY}`},
});
if (!response.ok) throw new Error((await response.json()).error.message);
const {data} = await response.json();
console.log(data.label, data.limit_remaining);
{
"data": {
"label": "production",
"is_management_key": false,
"limit": 100,
"limit_remaining": 63.25,
"limit_reset": "monthly",
"limit_resets_at": "2026-12-01T00:00:00.000Z",
"expires_at": "2027-01-01T00:00:00.000Z",
"usage_daily": 1.42,
"usage_weekly": 9.87,
"usage_monthly": 36.75,
"usage_90d": 112.4
}
}Management API
Get current API key
Describes the key that calls it: its name, credit limit and when it resets, expiration, and spend. Any API key can call it, inference keys included, so an application can check its own key’s remaining budget. The usage_ fields come from the same usage history as the Analytics page, so they can trail live traffic by a few minutes, and are null while that history can’t be read. A management key never spends: its usage_ fields are always 0.
GET
https://api.platform.pearlresearch.ai/api/v1
/
key
cURL
curl "https://api.platform.pearlresearch.ai/api/v1/key" \
-H "Authorization: Bearer $PEARL_API_KEY"import os
import requests
response = requests.get(
"https://api.platform.pearlresearch.ai/api/v1/key",
headers={"Authorization": f"Bearer {os.environ['PEARL_API_KEY']}"},
)
response.raise_for_status()
key = response.json()["data"]
print(key["label"], key["limit_remaining"])
const response = await fetch("https://api.platform.pearlresearch.ai/api/v1/key", {
headers: {Authorization: `Bearer ${process.env.PEARL_API_KEY}`},
});
if (!response.ok) throw new Error((await response.json()).error.message);
const {data} = await response.json();
console.log(data.label, data.limit_remaining);
{
"data": {
"label": "production",
"is_management_key": false,
"limit": 100,
"limit_remaining": 63.25,
"limit_reset": "monthly",
"limit_resets_at": "2026-12-01T00:00:00.000Z",
"expires_at": "2027-01-01T00:00:00.000Z",
"usage_daily": 1.42,
"usage_weekly": 9.87,
"usage_monthly": 36.75,
"usage_90d": 112.4
}
}