List orders created via Google checkout

GET/stores/{store_id}/orders

Authorization

AuthorizationBearer token (JWT) · headerrequired

JWT issued by the external IdP via the OAuth 2.0 authorization-code flow (Kinde in production; a simulator in test). The client obtains it and sends it as a Bearer token on every authenticated call. Sarvex's services verify it — issuer, audience, signature (IdP JWKS), expiry — and read identity and tenant from its claims. Sarvex does not issue or revoke these tokens. merchant_id/store_id are read from the verified claims (and the merchant→store mapping), never from the URL. The operator scope is required for /operator/*. Operators acting on a specific merchant pass the X-Operate-As header, which is recorded in the audit log.

Path parameters

store_idstringrequired

A store the caller's merchant owns. Authorized server-side against the principal; not a free-form tenant selector.

Query parameters

cursorstring

Opaque pagination cursor from the previous page's page.cursor.

limitinteger

Maximum items per page.

min 1 · max 100 · default: 25

statusorder_status

Allowed:createdconfirmedshippedcancelledrefunded

Responses

200

Orders.

dataorder[]required

Show properties

Array of order

order_idstring

checkout_session_idstring

store_order_refstring | null

Order id in the merchant store.

statusorder_status

Allowed:createdconfirmedshippedcancelledrefunded

sync_statestring

Allowed:pending_handoffcreatedsyncedfailed

valuemoney

Show properties

amount_minorintegerrequired

Amount in minor units (cents).

currencystringrequired

placed_atstring<date-time>

pagepagerequired

Show properties

cursorstring | nullrequired

has_morebooleanrequired

Try it

Server

Base URLCustom base URLOverrides the selected server when set.

Authorization

Bearer token (JWT)Remember on this deviceInclude my values in samples

Parameters

store_idpath*A store the caller's merchant owns. Authorized server-side against the principal; not a free-form tenant selector.cursorqueryOpaque pagination cursor from the previous page's `page.cursor`.limitqueryMaximum items per page.statusquery

Request

curl -X GET "https://api.sarvex.example.com/v1/stores/string/orders" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://api.sarvex.example.com/v1/stores/string/orders", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN"
  }
});

import requests

response = requests.get(
    "https://api.sarvex.example.com/v1/stores/string/orders",
    headers={
        "Authorization": "Bearer YOUR_TOKEN"
    },
)

Response

{
  "data": [
    {
      "order_id": "string",
      "checkout_session_id": "string",
      "store_order_ref": "string",
      "status": "created",
      "sync_state": "pending_handoff",
      "value": {
        "amount_minor": 0,
        "currency": "AUD"
      },
      "placed_at": "2019-08-24T14:15:22Z"
    }
  ],
  "page": {
    "cursor": "string",
    "has_more": true
  }
}