---
title: "Get current plan details."
method: GET
path: "/api/v1/billing/plan"
tags: ["Billing"]
---

# Get current plan details.

`GET /api/v1/billing/plan`

## Request

- Base URL: `https://app.customgpt.ai`
- URL: `https://app.customgpt.ai/api/v1/billing/plan`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/poll-the-people/apis/customgpt-ai/docs/api/v1/billing/plan/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns the active subscription plan for your account, including billing cycle dates, trial status, plan options, and active addons. Returns null data when no active subscription exists.

## Response `200`

Returns the active subscription plan details, or null when no active subscription exists.

- object
  - `status` 'error' | 'success': The status of the response
  - `data` BillingPlan
    - `name` string: The human-readable plan name.
    - `short_description` string: A brief summary of the plan.
    - `interval` 'monthly' | 'yearly': Billing interval.
    - `status` 'active' | 'trialing' | 'cancelling' | 'paused': Current lifecycle state of the subscription.
    - `current_period_start` integer: Unix timestamp of the start of the current billing cycle.
    - `current_period_end` integer: Unix timestamp of the end of the current billing cycle.
    - `addons` BillingAddon[]: Active add-ons purchased on top of the base plan.
      - `key` string: Add-on identifier.
      - `purchased_quantity` integer: Number of add-on units purchased.
      - `total_quantity` integer: Total additional capacity granted by this add-on.
      - `is_active` boolean: True when at least one unit of this add-on is active.
      - `interval` 'monthly' | 'yearly', nullable: Billing interval for this add-on.

## Other responses

- `401`: API Token is either missing or invalid
- `500`: Internal Server Error

## Changes

- **2026-11-03** `77aab4354382`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/poll-the-people/apis/customgpt-ai/changes/api/v1/billing/plan/get.md)

---

[API](https://skmtc.dev/poll-the-people/apis/customgpt-ai.md) - [All operations](https://skmtc.dev/poll-the-people/apis/customgpt-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/poll-the-people/apis/customgpt-ai/revisions/77aab4354382?raw)