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

status
enum<string>[]

Repeat the key to match more than one status, for example status=open&status=past_due.

The message of each variant is the label of the invoice document.

Available options:
open,
paid,
void,
draft,
past_due,
uncollectable
tags
enum<string>[]

Repeat the key to match an invoice that has any one of the tags.

Available options:
refunded,
partially_refunded,
disputed,
payment_reversed
customer_id
string
subscription_id
string
created_at_gte
string<date-time>
created_at_lte
string<date-time>
due_at_gte
string<date-time>
due_at_lte
string<date-time>
total_amount_gte
integer<int64>
total_amount_lte
integer<int64>
collection_method
enum<string>
Available options:
auto_charge,
manual
page_size
integer<int32>

Page size. The default is 10 and the maximum is 100.

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

Page number. The default is 0.

Required range: x >= 0

Response

items
object[]
required
Last modified on November 10, 2026