Skip to main content
GET
List orders
Returns the user’s orders, sorted by creation date descending.

Query parameters

integer
default:"50"
Number of results to return. Min 1, max 100.
integer
default:"0"
Number of results to skip for pagination.
string
Filter by order status. One of: new, waiting_payment, paid, provisioning_failed, provisioned, cancelled, refunded, expired. See Order statuses.

Response

array
List of order objects. Same shape as Create order response.
integer
Total number of orders matching the filter.
To find orders that still wait for payment, filter with status=waiting_payment: each one carries the payment_url to send the customer to. When the payment window closes unpaid, the order becomes expired and payment_url is null. A payment that arrives after that may be credited to your account balance, depending on the payment method; the order stays expired. See Payment methods for what happens to a payment that arrives late.

Example