---
title: "Subscription status"
method: GET
path: "/v1/billing/status"
tags: ["Billing"]
---

# Subscription status

`GET /v1/billing/status`

## Request

- Base URL: `https://api.marketintell.ai`
- URL: `https://api.marketintell.ai/v1/billing/status`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Get the current user's subscription status, plan tier, and billing details.

## Response `200`

Subscription status

- object
  - `success` boolean
  - `data` object
    - `tier` 'free' | 'pro'
    - `status` 'active' | 'cancelled' | 'past_due' | 'none'
    - `current_period_end` string, date-time, nullable
    - `cancel_at_period_end` boolean

---

[API](https://skmtc.dev/marketintell/apis/marketintell-api.md) · [All operations](https://skmtc.dev/marketintell/apis/marketintell-api/llms.txt) · [OpenAPI document](https://skmtc.dev/marketintell/apis/marketintell-api/revisions/f3ef87afc41f?raw)