Skip to main content
GET
/
v1
/
billing
/
subscription
Get Subscription
curl --request GET \
  --url https://api.example.com/v1/billing/subscription \
  --header 'Authorization: Bearer <token>'
{
  "id": "<string>",
  "dodo_subscription_id": "<string>",
  "dodo_customer_id": "<string>",
  "product_id": "<string>",
  "status": "pending",
  "tier": "<string>",
  "interval": "<string>",
  "credits_per_cycle": 123,
  "created_at": "2023-11-07T05:31:56Z",
  "current_period_start": "2023-11-07T05:31:56Z",
  "current_period_end": "2023-11-07T05:31:56Z",
  "next_billing_date": "2023-11-07T05:31:56Z",
  "cancel_at_next_billing_date": false
}

Authorizations

​
Authorization
string
header
required

JWT Bearer token for dashboard access

Response

200 - application/json
DodoSubscriptionResponse · object | null

Successful Response

Dodo subscription details.

​
id
string
required
​
dodo_subscription_id
string
required
​
dodo_customer_id
string
required
​
product_id
string
required
​
status
enum<string>
required

Dodo Payments subscription statuses.

Available options:
pending,
active,
on_hold,
cancelled,
failed,
expired
​
tier
string
required
​
interval
string
required
​
credits_per_cycle
integer
required
​
created_at
string<date-time>
required
​
current_period_start
string<date-time> | null
​
current_period_end
string<date-time> | null
​
next_billing_date
string<date-time> | null
​
cancel_at_next_billing_date
boolean
default:false