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

# Billing Status

`GET /billing/status`

## Request

- Base URL: `https://api.reeldrop.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.reeldrop.io/billing/status`
- Auth: HTTP bearer

Return the caller's current plan and subscription state.

## Response `200`

Successful Response

- BillingStatusResponse
  - `plan` 'starter' | 'influencer' | 'creator', required
  - `billing_type` string, nullable, required
  - `subscription_status` string, nullable, required
  - `subscription_current_period_end` string, nullable, required
  - `subscription_interval` string, nullable, required
  - `cancel_at_period_end` boolean, required
  - `is_active` boolean, required
  - `stripe_publishable_key` string, required
  - `image_gen_used` integer, required
  - `image_gen_limit` integer, nullable, required
  - `image_credits` integer, required
  - `referral_credit_months` integer
  - `referral_credit_cents` integer
  - `referral_credit_currency` string, nullable
  - `referral_comp_plan` string, nullable
  - `referral_comp_ends_at` string, nullable
  - `referral_half_off_months` integer
  - `referral_half_off_ends` string, nullable
  - `pending_plan` 'starter' | 'influencer' | 'creator'
  - `pending_plan_effective_at` string, nullable

---

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