---
title: "Get Account Entitlements"
method: GET
path: "/api/v1/account/entitlements"
tags: ["account"]
---

# Get Account Entitlements

`GET /api/v1/account/entitlements`

## Request

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

## Headers

- `X-Clerk-Session-Token` string, nullable

## Response `200`

Successful Response

- AccountEntitlements
  - `metadata` ResponseMetadata, required
    - `contract` 'index.v1' | 'swarms.v1' | 'core.v1', required
    - `request_id` string, required
    - `operation_id` string, nullable, required
    - `observed_at` string, date-time, required
    - `server_timing` TimingSpan[]
      - `name` 'request' | 'queue' | 'first_useful' | 'active' | 'wall' | 'settlement', required
      - `duration_ms` number, nullable, required
      - `source` 'server' | 'worker' | 'unknown', required
      - `clock` 'monotonic' | 'utc' | 'unknown', required
      - `uncertainty_ms` number, nullable, required
    - `client_timing` ClientTiming
      - `total_ms` number, required
      - `first_byte_ms` number, required
      - `attempts` integer, required
      - `source` 'sdk_monotonic'
  - `tenant_id` string, required
  - `policy_revision` integer, required
  - `definition_version` 'account-policy.v1'
  - `capability_sha256` string, nullable, required
  - `limits_observed_at` string, date-time, required
  - `request_limits` AccountRequestLimits, required
    - `max_results` integer, required
    - `max_excerpts_per_result` integer, required
    - `query_max_bytes` integer, required
    - `contents_max_bytes` integer, required
  - `subproducts` AccountEntitlement[], required
    - `subproduct` 'index.fast' | 'index.deep' | 'index.private' | 'index.contributions' | 'swarms.docker' | 'swarms.daytona' | 'swarms.openrouter' | 'swarms.openai' | 'swarms.tinker' | 'swarms.synth' | 'monitor', required
    - `product` 'index' | 'swarms' | 'monitor', required
    - `stage` 'available' | 'planned' | 'unavailable', required
    - `kind` 'search' | 'content' | 'compute' | 'provider' | 'monitor', required
    - `supply` 'platform' | 'customer' | 'mixed', required
    - `access` 'allowed' | 'denied' | 'conditional' | 'unavailable', required
    - `code` string, required
    - `conditions` string[], required
    - `source` 'baseline' | 'override' | 'unavailable', required
    - `grant_revision` integer, nullable, required
    - `expires_at` string, date-time, nullable, required
    - `limits` AccountPolicyLimit[], required
      - `limit_id` string, required
      - `product` 'index' | 'swarms', required
      - `value` integer, nullable, required
      - `default_value` integer, nullable, required
      - `source` string, required
      - `revision` string, nullable, required
      - `expires_at` string, date-time, nullable, required
      - `dimension` 'requests' | 'concurrent' | 'spend_cents', required
      - `window` 'token_bucket' | 'concurrent' | 'day' | 'month', required
      - `observed_at` string, date-time, required
      - `state` 'ready' | 'unavailable', required
      - `code` string, nullable, required
      - `used` integer, nullable, required
      - `remaining` integer, nullable, required
      - `resets_at` string, date-time, nullable, required
      - `burst_capacity` integer, nullable, required
      - `available_requests` integer, nullable, required
      - `next_request_at` string, date-time, nullable, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `406`: Not Acceptable
- `409`: Conflict
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `502`: Bad Gateway
- `503`: Service Unavailable

---

[API](https://skmtc.dev/usesynth/apis/synth-api.md) - [All operations](https://skmtc.dev/usesynth/apis/synth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/usesynth/apis/synth-api/revisions/4d199548e98a?raw)