API reference Orders List orders

List orders

GET methodhttps://api.anyshop.io/v1/orders

Orders in your API key's mode, newest first. Checkouts never paid are not listed.

Scope orders:read

Query parameters

limitinteger How many to return: 1 to 100, default 201 to 100
starting_afterstring The last ID of the previous page; the next page starts after itUp to 64 characters
statusenum Only orders in this statuspending_paymentpaiddeliveredrefunded
emailstring Only this buyer's orders: their email address, exactlyUp to 254 characters

Example

as_live_ or as_test_

curl https://api.anyshop.io/v1/orders \
  -H "Authorization: Bearer $ANYSHOP_API_KEY"

{
  "object": "list",
  "data": [
    {
      "object": "order",
      "id": "ord_01m3rt5x2c7q9f0a4d6k8h1n3p",
      "number": 1001,
      "livemode": false,
      "status": "delivered",
      "currency": "USD",
      "subtotal": 1999,
      "discount": 0,
      "total": 1999,
      "refunded": 0,
      "coupon": null,
      "buyer": {
        "email": "buyer@example.com"
      },
      "paid_with": "simulated",
      "created_at": "2026-10-02T14:21:07.000Z",
      "paid_at": "2026-10-02T14:21:07.000Z",
      "delivered_at": "2026-10-02T14:21:07.000Z",
      "items": [
        {
          "id": "oi_01m3rt5x4e9s1h2c6d8f0g2j4k",
          "product": {
            "id": "prod_01m3rr5kmbeb2s18x1kpntjxqb",
            "name": "Lumen Studio Pro",
            "type": "serial"
          },
          "variant": {
            "id": "var_01m3rr5kmd6h0q2t8w4y9zb7ce",
            "name": "Standard"
          },
          "quantity": 1,
          "unit_amount": 1999,
          "total_amount": 1999,
          "delivery_state": "pending"
        }
      ]
    }
  ],
  "has_more": false
}

The IDs and keys in these examples are made up. Every schema is in the OpenAPI document, served at https://api.anyshop.io/v1/openapi.json.

Returns

A list of order objects, newest first: { "object": "list", "data", "has_more" }.

Errors

Status and error.type

400invalid_requestThe request is not valid; error.param names the field
401authenticationNo API key, or it is not valid
403permissionThe key does not have the scope this needs, it is a test key where only a live key may act (the catalog), or the store is suspended (store_suspended)
404not_foundNot found in the key's store and mode
409conflictConflicts with the object's state (type conflict), or an Idempotency-Key reused for another request (type idempotency, code idempotency_key_reused)
429rate_limitedToo many requests; see Retry-After