Subscriptions

GET/api/v1/subscriptions returns the current account's subscription row, or JSON null when no row exists yet.

Read-only. Checkout, webhooks, and plan changes are not available on public REST.

For resolved limits, features, and usage meters, see Billing (billing: read).

Authentication: subscriptions: read.

See Scopes and Errors.

Get subscription

No query parameters.

Response

200: JSON object or null. Timestamps are Unix milliseconds. Field names match the legacy Convex-style payload (snake_case Stripe fields where applicable).

{
  "_id": "uuid",
  "_creationTime": 1710000000000,
  "userId": "internal-user-uuid",
  "clerk_user_id": "user_…",
  "stripe_customer_id": "cus_…",
  "plan_key": "pro",
  "subscription_status": "active",
  "current_period_end": 1712592000000,
  "cancel_at_period_end": false,
  "lifetime_custom_fields_unlocked": false,
  "donor_supporter_unlocked": false,
  "createdAt": 1710000000000,
  "updatedAt": 1710000000000
}

cURL

curl -sS \
  -H "Authorization: Bearer YOUR_TOKEN" \
  "https://api.floralitys.com/api/v1/subscriptions"

Status codes

• 200: body is subscription object or null
• 400: unknown query parameters
• 401 / 403: auth / scope
• 503: PRECONDITION_FAILED when DATABASE_URL is not configured