---
title: "Get caller's subscription + plan limits + feature flags"
method: GET
path: "/user/subscription"
tags: ["User"]
---

# Get caller's subscription + plan limits + feature flags

`GET /user/subscription`

Returns the caller's subscription details (plan ID + plan-tier limits) and
feature-flag map. Useful for client-side gating of paid features.

**`limits` is omitted** for the `ENTERPRISE` plan (and for unknown plan IDs) —
only `features` is returned in those cases.

## Response `200`

Subscription details + limits + features.

- object
  - `status` boolean
  - `data` object
    - `planId` string
    - `limits` object — Per-plan caps. Omitted for ENTERPRISE.
      - `agents` integer
      - `campaigns` integer
      - `numbers` integer
      - `dailyCalls` integer
      - `concurrentCalls` integer
      - `knowledgeBaseItemLimit` integer
      - `knowledgeBaseLimits` object
    - `features` object — Feature-flag map. All keys are boolean.
      - `chat` boolean
      - `telephony` boolean
      - `campaign` boolean
      - `webcall` boolean
      - `knowledge_base` boolean
      - `integrations` boolean
      - `webhooks` boolean
      - `telephony_inbound` boolean
      - `telephony_outbound` boolean
      - `waves_lightning` boolean
      - `waves_lightning_large` boolean
      - `waves_lightning_large_voice_clone` boolean
      - `openai_gpt_4o` boolean
      - `electron` boolean
      - `workflow_editor` boolean

## Other responses

- `400` — Bad request — validation failed or required field missing.
- `401` — Unauthorized access
- `500` — Internal server error

## Changes

- **2026-06-21** `ea4ea58d7c4e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/smallest-inc/apis/agent-management-api/changes/user/subscription/get.md)

---

[API](https://skmtc.dev/smallest-inc/apis/agent-management-api.md) · [All operations](https://skmtc.dev/smallest-inc/apis/agent-management-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smallest-inc/agent-management-api/revisions/ea4ea58d7c4e/schema)