Skip to main content
GET
JavaScript

Authorizations

Authorization
string
header
required

Send your API key as a bearer token: Authorization: Bearer <api_key>. A test mode key starts with dodo_test_, for example dodo_test_AbCd1234EfGh5678.<secret>. A live mode key starts with dodo_live_. Use a test mode key on test.dodopayments.com and a live mode key on live.dodopayments.com. Keys from before these tags have no tag and operate as before.

Query Parameters

created_at_gte
string<date-time>

Get events after this created time

created_at_lte
string<date-time>

Get events created before this time

page_size
integer<int32>

Page size default is 10 max is 100

Required range: x >= 0
page_number
integer<int32>

Page number default is 0

Required range: x >= 0
customer_id
string

Filter by customer id

status
enum<string>

Filter by status

Available options:
pending,
active,
on_hold,
paused,
cancelled,
failed,
expired,
past_due
brand_id
string

filter by Brand id

product_id
string

Filter by product id

cancel_at_next_billing_date
boolean

Filter by cancel_at_next_billing_date (subscriptions scheduled for cancellation)

Response

items
object[]
required
Last modified on May 26, 2026