---
title: "Get subscription info"
method: POST
path: "/api/subscription"
tags: ["Subscription"]
---

# Get subscription info

`POST /api/subscription`

## Request

- Base URL: `https://v3-api.newscatcherapi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://v3-api.newscatcherapi.com/api/subscription`
- Auth: none declared. Required headers: `x-api-token`

Returns plan and usage info for the API key used to authenticate this request: subscription status, concurrency and monthly call limits, remaining call quota, and the historical date range your plan allows searching.

## Headers

- `x-api-token` string, required: Your NewsCatcher API key, used to authenticate this request.

## Response `200`

Successful Response

- SubscriptionResponse: SubscriptionResponse DTO class.
  - `active` boolean, required: Whether this API key's subscription is currently active.
  - `calls_per_seconds` integer: Maximum number of concurrent API requests allowed per second under your plan. Exceeding this returns a 429 Too Many Requests error.
  - `plan_name` string, required: Name of your subscription plan (e.g. 'v3_basic', 'v3_nlp').
  - `usage_assigned_calls` integer: Total number of API calls assigned to your plan for the current billing period.
  - `usage_remaining_calls` integer: Number of API calls remaining in the current billing period. Requests are rejected once this reaches zero.
  - `historical_days` integer: Number of days of historical article data your plan allows querying.

## Other responses

- `401`: Missing or invalid `x-api-token` header.
- `422`: Validation Error
- `500`: Internal server error. Please contact support.

---

[API](https://skmtc.dev/newscatcherapi/apis/newscatcher-v3-production-api.md) - [All operations](https://skmtc.dev/newscatcherapi/apis/newscatcher-v3-production-api/llms.txt) - [OpenAPI document](https://skmtc.dev/newscatcherapi/apis/newscatcher-v3-production-api/revisions/a3950aefb3e5?raw)