Read the effective API allowance

Shared across every API key and member. Null limits mean Unlimited, subject to independent fair-use protections. No remote billing request.

GET/billing/limits

Authorization

AuthorizationBearer token · headerrequired

`MEDIAN_KEY` from Settings under API, or an MCP OAuth access token. A key acts as the organization; a token acts as the person who approved it.

Responses

200Local organization records.

tierstringrequired

Allowed:explorestandardhigherhighestunlimited

versionstringrequired

limitsany | objectrequired

Show properties

One of:

any

any

object

readobject

Show properties

perMinuteinteger

burstinteger

writeobject

Show properties

perMinuteinteger

burstinteger

uploadobject

Show properties

perMinuteinteger

burstinteger

401Invalid or missing credentials.

403The authenticated role cannot read these records.

429Shared organization API allowance or temporary fair-use protection reached. Retry-After states the delay.

Request

curl -X GET "https://api.median.sh/v1/billing/limits" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.median.sh/v1/billing/limits", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

Response

{
  "tier": "explore",
  "version": "string",
  "limits": "string"
}