List orders
using System.Net.Http.Headers;var client = new HttpClient();var request = new HttpRequestMessage{ Method = HttpMethod.Get, RequestUri = new Uri("https://api.azimea.com/v1/commerce/orders?storeId=null&search=null&status=null&view=Paid&days=30&page=1&pageSize=50"), Headers = { { "Authorization", "Bearer <token>" }, },};using (var response = await client.SendAsync(request)){ response.EnsureSuccessStatusCode(); var body = await response.Content.ReadAsStringAsync(); Console.WriteLine(body);}const url = 'https://api.azimea.com/v1/commerce/orders?storeId=null&search=null&status=null&view=Paid&days=30&page=1&pageSize=50';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.azimea.com/v1/commerce/orders?storeId=null&search=null&status=null&view=Paid&days=30&page=1&pageSize=50' \ --header 'Authorization: Bearer <token>'The orders of your connected stores, newest first, in pages (page from 1, pageSize 1–200, default 50). Statuses are the same for every platform: Pending, Paid, Completed, Cancelled, Refunded, Failed, Draft. Filter by storeId, by status, by view (All, Paid = paid or completed, Pending, Abandoned = orders left at checkout, Refunded), by the last days (1–3660, by placement date), or with search over the order number, email and name (at most 100 characters). Needs the orders:read permission.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Example
nullExample
nullExample
nullExample
PaidExample
30Example
1Example
50Responses
Section titled “Responses”One page of orders
object
true when the call worked, false when errors say why it did not.
The answer itself; null when the call failed.
object
The orders on this page, newest first.
object
Azimea’s id for the order.
The connected store the order came from.
The order number as the buyer sees it; it can differ from the store’s internal id.
Where the order stands. See the order statuses catalog.
The three-letter currency code of total.
The order’s total, in currency.
The buyer’s email address.
The buyer’s name.
When the order was placed.
When it was paid; null while it is not.
How many lines (products) the order has.
The page number, starting at 1.
How many orders a full page holds.
How many orders match in all, across every page.
An internal result number. Rely on the HTTP status code instead.
What went wrong, one entry per problem; empty when the call worked.
object
A stable code such as audience.contact_not_found. Branch on this, never on message. Every code is listed in the error codes catalog.
An English sentence for your logs. Do not show it to end users: it can change.
The numbers the message mentions (a minimum, a maximum), when there are any.
object
The same problems grouped by the request field they belong to; null when none is tied to a field.
object
object
A stable code such as audience.contact_not_found. Branch on this, never on message. Every code is listed in the error codes catalog.
An English sentence for your logs. Do not show it to end users: it can change.
The numbers the message mentions (a minimum, a maximum), when there are any.
object
Example
{ "isSuccess": true, "value": { "items": [ { "id": "01a10900-0000-7000-8000-000000000101", "storeId": "01a10900-0000-7000-8000-000000000201", "number": "1042", "status": "Paid", "currency": "EUR", "total": 129.9, "email": "emma@example.com", "customerName": "Emma Clarke", "placedAt": "2026-10-04T18:12:00+00:00", "paidAt": "2026-10-04T18:13:00+00:00", "lineCount": 2 } ], "page": 1, "pageSize": 50, "totalCount": 1 }, "status": 0, "errors": [], "fieldErrors": null}Validation failed: see errors[].code and fieldErrors
object
true when the call worked, false when errors say why it did not.
The answer itself; null when the call failed.
An internal result number. Rely on the HTTP status code instead.
What went wrong, one entry per problem; empty when the call worked.
object
A stable code such as audience.contact_not_found. Branch on this, never on message. Every code is listed in the error codes catalog.
An English sentence for your logs. Do not show it to end users: it can change.
The numbers the message mentions (a minimum, a maximum), when there are any.
object
The same problems grouped by the request field they belong to; null when none is tied to a field.
object
object
A stable code such as audience.contact_not_found. Branch on this, never on message. Every code is listed in the error codes catalog.
An English sentence for your logs. Do not show it to end users: it can change.
The numbers the message mentions (a minimum, a maximum), when there are any.
object
Example
{ "isSuccess": false, "value": null, "status": 5, "errors": [ { "code": "validation.required", "message": "Fill in this field.", "params": null } ], "fieldErrors": { "email": [ { "code": "validation.required", "message": "Fill in this field.", "params": null } ] }}Missing or invalid API key
The key lacks the orders:read permission
Too many requests for this key