Export orders
The orders the same filters would list, as a CSV file: a row an order with every field its page shows (when it was paid, the fee, tax, balance and affiliate in it, the currency it was charged in, the billing address), or a row a product line with rows=lines. The first thirteen columns are always Order ID, Created, Email, Status, Payment, Currency, Subtotal, Discount, Total, Coupon, Country, Items and Products, in that order. No delivered key is in it. Every order the filters match is in the file, however many: it is sent as it is read, with no length given. Add check=1 for { rows }, how many it would have, which is not counted. A store exports at most 30 files every 10 minutes, orders, customers, fraud events and blacklist rules together, whoever asks: after that the answer is 429.
Needs the orders.read permission (Read Orders). It is one of the heavier reads, and is counted against a smaller budget of its own: 60 a minute for each key.
Authorizations
A secret API key, made under Developers in the dashboard: Authorization: Bearer shoply_sk_...
Path Parameters
The store's ID. A key reaches the store it was made in: GET /key answers which.
Query Parameters
Only orders in this status.
pending, completed, refunded, cancelled, chargeback Only orders paid with this payment method, by its name in the payment methods list.
"stripe"
An order's ID, or part of a buyer's email.
What the list is ordered by.
created_at, amount, email, status Which way it is ordered.
asc, desc Only orders placed in this period.
today, yesterday, 7d, 30d, this_week, last_week, this_month, last_month, this_year Only orders placed on or after this day, as YYYY-MM-DD. With to, in place of range.
"2026-10-01"
Only orders placed on or before this day, as YYYY-MM-DD.
"2026-10-31"
The time zone the days of range, from and to are in, as an IANA name. Left out, UTC.
"Europe/Berlin"
What a row is: an order, or one product line of one.
orders, lines 1 for how many rows the file would have, as { rows }, in place of the file. Not counted against the store's exports, and refused with 429 where none are left.
1 Response
The file itself, not a JSON envelope.
The response is of type file.

