---
title: "Get current API tier and limits"
method: GET
path: "/api/v1/account/tier"
tags: ["Account"]
---

# Get current API tier and limits

`GET /api/v1/account/tier`

## Request

- Base URL: `https://api.bellatorsi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.bellatorsi.com/api/v1/account/tier`
- Auth: none declared

Returns the subscription tier and limits for the authenticated API key. Used by the official Bellator SI Dashboard for dynamic feature gating. Fully stateless and lightweight.

## Headers

- `x-api-key` string, nullable
- `authorization` string, nullable
- `x-bellator-internal-dispatch` string, nullable

## Response `200`

Successful Response

- AccountTierResponse: Response model for GET /api/v1/account/tier. Not wrapped in BellatorResponse[T]. This is an identity and capability endpoint — no schedule is submitted, no pass/fail evaluation is made, and findings/recommendations are not applicable. Attributes: tier: Lowercase tier identifier. display_name: Human-readable tier display name. limits: Numeric limits for this tier. capabilities: Boolean feature flags for dashboard gating. recommended_routes: Accessible API route templates for this tier. metadata: Audit context — resolution timestamp and API version.
  - `tier` string, required: Lowercase tier identifier: demo | free | starter | professional | enterprise | government
  - `display_name` string, required: Human-readable tier display name.
  - `limits` TierLimits, required: Numeric limits for the authenticated tier. Attributes: sync_task_limit: Maximum tasks per synchronous request. Always 1,000. max_task_limit: Maximum tasks per request across sync + async combined. payload_limit_mb: Maximum request payload size in megabytes. api_calls_per_month: Monthly API call quota. Null for unlimited tiers. monthly_calls_remaining: Remaining calls this month from Redis. Null if Redis unavailable or tier is unlimited.
    - `sync_task_limit` integer, required: Maximum tasks per synchronous request. Always 1,000 for all tiers.
    - `max_task_limit` integer, required: Maximum tasks per request across sync + async combined. Tier-dependent.
    - `payload_limit_mb` integer, required: Maximum request payload size in MB.
    - `api_calls_per_month` integer, nullable: Monthly API call quota. Null for unlimited tiers (Enterprise, Government).
    - `monthly_calls_remaining` integer, nullable: Remaining calls this billing month. Null if Redis unavailable or tier is unlimited.
  - `capabilities` TierCapabilities, required: Boolean feature flags for dashboard gating. The 'async' and 'import' JSON keys are Python reserved words. They are declared as 'async_jobs' and 'import_api' with serialization_alias set so the JSON output uses the correct names ('async' and 'import'). Construct from Python using async_jobs=True and import_api=True. Attributes: tier1: Access to Tier 1 APIs: Health Score, CPM, Validation. forensics: Access to Tier 2 forensics endpoints. import_api: Access to Import APIs (MPP, XER). JSON key: "import". risk: Access to Tier 3 Risk & Simulation APIs (v0.3.0+). async_jobs: Async job submission available (Starter+). JSON key: "async". webhooks: Webhook callback registration supported. sandbox_fixture_requests: Sandbox fixture system available.
    - `tier1` boolean, required: Access to Tier 1 APIs: Health, CPM, Validation.
    - `forensics` boolean, required: Access to Tier 2 forensics: Logic Audit, Progress Audit, DCMA 14-Point, DCMA DECM, Resource Analysis.
    - `import` boolean, required: Access to Import APIs: MPP and XER file parsing.
    - `risk` boolean, required: Access to Tier 3 Risk & Simulation APIs (v0.3.0+).
    - `async` boolean, required: Async job submission available. True for Starter and above.
    - `webhooks` boolean, required: Webhook callback registration supported. Same tier gate as async.
    - `sandbox_fixture_requests` boolean, required: Sandbox fixture request system available. False for Demo tier only.
  - `recommended_routes` object, required: Accessible API route templates filtered to this tier's capabilities.
  - `metadata` AccountTierMetadata, required: Audit context for the tier resolution. Attributes: resolved_at: UTC ISO 8601 timestamp when the tier was resolved. api_version: API version that produced this response.
    - `resolved_at` string, required: UTC ISO 8601 timestamp of tier resolution.
    - `api_version` string, required: API version that produced this response.

## Other responses

- `401`: Invalid or missing API key
- `403`: API key inactive or suspended
- `422`: Validation Error
- `429`: Rate limit exceeded
- `500`: Internal resolution error

---

[API](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis.md) · [All operations](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/bellatorsi/apis/bellator-schedule-intelligence-apis/revisions/03e7b786e43b?raw)