Skip to main content

​
GET /api/v1/subscriptions/status

Return the current subscription tier, status, credit balance, and billing details for your account.

​
Response

​
tier
string
Current plan: "developer" or "pro".
​
status
string
Stripe subscription status: "active", "inactive", "past_due", "canceled", etc.
​
credits_total
integer
Total available credits (permanent + unexpired temporary grants).
​
credits_expiring
string
ISO 8601 timestamp of the earliest expiring credit grant. null when none.
​
monthly_cost
number
Current monthly USD cost including add-ons.
​
addons
array
List of active add-on type strings (e.g. ["starter", "fuel"]).
​
addon_quantities
object
Map of add-on type to quantity (e.g. { "fuel": 2 }).
​
next_billing_date
string
ISO 8601 timestamp of the next billing event.
​
current_period_start
string
ISO 8601 start of the current billing period.
​
current_period_end
string
ISO 8601 end of the current billing period.

​
Example

cURL
curl https://api.deepcurrent.app/api/v1/subscriptions/status \
  -H "Authorization: Bearer $TOKEN"
Response
{
  "tier": "pro",
  "status": "active",
  "credits_total": 4200,
  "credits_expiring": null,
  "monthly_cost": 99.00,
  "addons": ["fuel"],
  "addon_quantities": { "fuel": 1 },
  "next_billing_date": "2026-05-08T00:00:00Z",
  "current_period_start": "2026-04-08T00:00:00Z",
  "current_period_end": "2026-05-08T00:00:00Z"
}

​
POST /api/v1/subscriptions/checkout-session

Create a Stripe Checkout Session for subscribing to the Pro plan. Payments are processed via Stripe’s crypto/stablecoin checkout.

​
Request body

​
tier
string
required
Must be "pro". Other tiers require direct contact.
​
add_ons
array
Optional list of add-on type strings to include in the subscription from the start.

​
Response

​
checkout_url
string
Stripe-hosted checkout URL. Redirect the user to this URL to complete payment.
​
checkout_session_id
string
Stripe checkout session ID for reference.

​
Example

cURL
curl -X POST https://api.deepcurrent.app/api/v1/subscriptions/checkout-session \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "tier": "pro", "add_ons": [] }'
Response
{
  "checkout_url": "https://checkout.stripe.com/c/pay/cs_live_...",
  "checkout_session_id": "cs_live_a1B2c3D4e5F6g7H8"
}
After the user completes checkout, Stripe sends a webhook to DeepCurrent which activates the subscription and credits the account. The status field in GET /subscriptions/status will update to "active" once the webhook is processed.