Billing

Get a project's subscription state

Billing state of one project, derived from the same fields the access gate reads. status: active (live paid month — work endpoints are all-inclusive), pending_payment (an API-created checkout is in flight, <24h old), or none. plan is basic/pro when resolvable (manual-tier marker or live Creem lookup), else null. Sandbox projects always report none (they run on the free trial budget).

get/v1/subscription

Request

  • Base URL: https://serp-agent.com
  • URL: https://serp-agent.com/v1/subscription
  • Auth: HTTP bearer

Query parameters

project_idstring required

Project id.

Response

The project's subscription state.

project_idstring required
plan'basic' | 'pro' | 'null' nullable required

Null when no subscription or the tier cannot be resolved.

status'active' | 'pending_payment' | 'none' required

active = live paid month (work endpoints all-inclusive); pending_payment = API checkout in flight; none = no subscription (pay per unit with credits, or subscribe).

paid_untilstring date-time

Present when active.

sandboxboolean

Present (true) on sandbox projects — they run on the free trial budget, no subscription.

notestring

Changes

No recorded changes to this operation across all 1 revision of this API.