---
title: "Get subscription and plan limits"
method: GET
path: "/user/subscription"
tags: ["User"]
---

# Get subscription and plan limits

`GET /user/subscription`

Returns the organization's current subscription: plan id, credit balance,
renewal date, and the per-plan `limits` (agents, campaigns, numbers, daily and
concurrent calls, knowledge-base sizes) plus the `features` map that gates
capabilities like telephony, campaigns, and webhooks. Use it to check remaining
credits or whether a feature is enabled before attempting an action.

## Response `200`

Successful response

- object
  - `status` boolean
  - `data` object — The subscription record. Extra fields may be present.
    - `_id` string
    - `organization` string
    - `planId` string — The active plan identifier.
    - `totalCredits` number
    - `currentCredits` number — Credits remaining in the current cycle.
    - `renewalDate` string, date-time
    - `subscriptionActive` boolean
    - `onPremEnabled` boolean
    - `limits` object — Per-plan quotas.
      - `agents` integer
      - `campaigns` integer
      - `numbers` integer
      - `dailyCalls` integer
      - `concurrentCalls` integer
      - `knowledgeBaseItemLimit` integer
      - `knowledgeBaseLimits` integer
    - `features` object — Feature flags gating capabilities for this plan.

## Other responses

- `401` — Unauthorized access
- `500` — Internal server error

---

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