GET/api/v1/account/tier

Get current API tier and limits

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.

Request example

json

{
  "tasks": [
    {
      "id": "T1",
      "duration_days": 5
    }
  ]
}

Response example

json

{
  "score": 92,
  "grade": "A"
}

Response fields from OpenAPI contract

This table is generated from the endpoint response schema in openapi.json.

Field	Type	Required	Description
tier	string	Required	Lowercase tier identifier: demo \| free \| starter \| professional \| enterprise \| government
display_name	string	Required	Human-readable tier display name.
limits	object	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.
limits.sync_task_limit	integer	Required	Maximum tasks per synchronous request. Always 1,000 for all tiers.
limits.max_task_limit	integer	Required	Maximum tasks per request across sync + async combined. Tier-dependent.
limits.payload_limit_mb	integer	Required	Maximum request payload size in MB.
limits.api_calls_per_month	integer \| null	Optional	Monthly API call quota. Null for unlimited tiers (Enterprise, Government).
limits.monthly_calls_remaining	integer \| null	Optional	Remaining calls this billing month. Null if Redis unavailable or tier is unlimited.
capabilities	object	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.
capabilities.tier1	boolean	Required	Access to Tier 1 APIs: Health, CPM, Validation.
capabilities.forensics	boolean	Required	Access to Tier 2 forensics: Logic Audit, Progress Audit, DCMA 14-Point, DCMA DECM, Resource Analysis.
capabilities.import	boolean	Required	Access to Import APIs: MPP and XER file parsing.
capabilities.risk	boolean	Required	Access to Tier 3 Risk & Simulation APIs (v0.3.0+).
capabilities.async	boolean	Required	Async job submission available. True for Starter and above.
capabilities.webhooks	boolean	Required	Webhook callback registration supported. Same tier gate as async.
capabilities.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	object	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.
metadata.resolved_at	string	Required	UTC ISO 8601 timestamp of tier resolution.
metadata.api_version	string	Required	API version that produced this response.

Schema

json-schema

{
  "$ref": "#/components/schemas/AccountTierResponse"
}

Authentication

x-api-key header

Reference details

Operation ID: get_account_tier_api_v1_account_tier_get
Section: Account
Tags: Account

Was this page helpful?

Your feedback helps us improve docs, reference pages, and Playground flows.

Topic: Get current API tier and limits · Page: /docs/api-reference/get_account_tier_api_v1_account_tier_get

Report an issue Suggest improvement

Terms Privacy Contact

Schedule analysis guidance. Not legal advice. You remain responsible for contract and agency compliance.