Get subscription details

GET

/v1/billing/subscription

• Production

Retrieve the current subscription status, plan limits, and usage. Returns free tier limits if no paid subscription exists.

Authorizations

• SessionAuth
• BearerAuth

Responses

200

Subscription details retrieved successfully

object

data

object

plan

Current subscription plan

string

Allowed values: free pro business enterprise

Example

pro

status

Subscription status

string

Allowed values: active canceled past_due trialing unpaid

Example

active

limits

object

plan

string

Example

pro

messages_per_month

integer

Example

50000

max_projects

integer

Example

100

max_endpoints

integer

Example

10000

retention_days

integer

Example

7

usage

object

messages_used

Messages used in current period

integer

Example

12500

period_start

string format: date-time

Example

2025-12-01T00:00:00Z

period_end

string format: date-time

Example

2025-12-31T23:59:59Z

cancel_at_period_end

Whether subscription will cancel at period end

boolean

current_period_end

When current billing period ends

string format: date-time

Example

2025-12-31T23:59:59Z

meta

object

request_id

Unique identifier for this request (useful for support)

string

Example

req_xyz123

Example

{
  "data": {
    "plan": "pro",
    "status": "active",
    "limits": {
      "plan": "pro",
      "messages_per_month": 50000,
      "max_projects": 100,
      "max_endpoints": 10000,
      "retention_days": 7
    },
    "usage": {
      "messages_used": 12500,
      "period_start": "2025-12-01T00:00:00Z",
      "period_end": "2025-12-31T23:59:59Z"
    },
    "cancel_at_period_end": false,
    "current_period_end": "2025-12-31T23:59:59Z"
  },
  "meta": {
    "request_id": "req_xyz123"
  }
}

401

Unauthorized - Invalid or missing API key

object

error

object

code

Machine-readable error code

string

Example

INVALID_REQUEST

message

Human-readable error message

string

Example

endpoint must be a valid HTTPS URL

meta

object

request_id

Unique identifier for this request (useful for support)

string

Example

req_xyz123

Example

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  },
  "meta": {
    "request_id": "req_xyz123"
  }
}