API ReferenceEndpointsCustomersList customer orders

List customer orders

Lists the orders of the signed-in customer that came through this channel, newest first.

GET
/vc/{connectionId}/customers/me/orders
X-Sales-Channel-Origin<token>

For /api/vc/{connectionId}/* routes the connectionId (vc_*) is in the URL path — not a header. Live-mode requests must also send a matching Origin header.

In: header

Path Parameters

connectionIdstring

Sales channel ID (vc_*), the canonical salesChannelId. connectionId is the deprecated name of the same value and is still the literal path segment.

Query Parameters

page?integer

Page number, starting at 1.

Default1
limit?integer

Page size. Values above 50 are capped at 50.

Default10
Rangevalue <= 50

Header Parameters

originstring

Origin of the storefront page making the call, for example https://shop.example.com. Required: a request with no Origin header is refused with 403. On a LIVE channel its host must equal the channel's registered domain (or one of its subdomains) or match an allowed origin. A TEST channel with no domain accepts any origin; once a domain is set it is matched as on LIVE.

authorizationstring

Customer token as Bearer <token>, returned by customers/login, customers/register or the OAuth callback. Expires after 7 days. It is a customer token, never an API key.

X-SDK-Version?string

Version of the calling SDK (the Brainerce SDK sends it automatically). Informational: it is recorded on the channel and never changes the response.

curl -X GET "https://api.brainerce.com/api/vc/string/customers/me/orders?page=1&limit=10" \  -H "origin: string" \  -H "authorization: string" \  -H "X-SDK-Version: string"
{
  "data": [
    {
      "id": "clord_abc123",
      "orderNumber": "ORD-20260907-0012",
      "status": "processing",
      "totalAmount": "46.96",
      "total": "46.96",
      "subtotal": "39.80",
      "discountAmount": "0",
      "couponCode": "WELCOME10",
      "couponDiscount": "19.99",
      "ruleDiscountAmount": "19.99",
      "appliedDiscounts": [
        {}
      ],
      "shippingAmount": "5.00",
      "taxAmount": "0",
      "currency": "ILS",
      "createdAt": "2026-01-15T10:30:00.000Z",
      "itemCount": 2,
      "items": [
        {
          "productId": "clprd_abc123",
          "variantId": "clvariant_abc123",
          "sku": "MUG-BLU-L",
          "name": "string",
          "quantity": 2,
          "price": "19.90",
          "unitPrice": "19.90",
          "totalPrice": "39.80",
          "image": "https://cdn.example.com/products/mug.jpg",
          "customizations": {},
          "modifiers": [
            {}
          ]
        }
      ],
      "hasDownloads": false,
      "notes": "string",
      "tenders": [
        {
          "id": "cltnd_abc123",
          "type": "GIFT_CARD",
          "amountBase": "25.00",
          "currencyBase": "ILS",
          "giftCard": {
            "id": "string",
            "codeLast4": "string"
          }
        }
      ],
      "taxBreakdown": {
        "subtotal": 39.8,
        "shippingNet": 5,
        "totalTax": 7.16,
        "total": 46.96,
        "pricesIncludeTax": true,
        "breakdown": [
          {
            "name": "VAT",
            "rate": 0.18,
            "amount": 7.16,
            "taxClassId": "cltxc_abc123",
            "taxClassSlug": "reduced",
            "rateId": "cltxr_abc123"
          }
        ],
        "currency": "ILS"
      },
      "shippingAddress": {
        "firstName": "string",
        "lastName": "string",
        "company": "string",
        "line1": "string",
        "line2": "string",
        "city": "string",
        "region": "string",
        "state": "string",
        "postalCode": "string",
        "country": "US",
        "phone": "string"
      },
      "billingAddress": {
        "firstName": "string",
        "lastName": "string",
        "company": "string",
        "line1": "string",
        "line2": "string",
        "city": "string",
        "region": "string",
        "state": "string",
        "postalCode": "string",
        "country": "US",
        "phone": "string"
      },
      "deliveryType": "shipping",
      "paymentMethod": "card",
      "financialStatus": "paid",
      "fulfillmentStatus": "unfulfilled",
      "trackingNumber": "1Z999AA10123456784",
      "trackingUrl": "https://shop.example.com/page",
      "carrier": "ups",
      "shippedAt": "2026-01-15T10:30:00.000Z",
      "deliveredAt": "2026-01-15T10:30:00.000Z"
    }
  ],
  "meta": {
    "page": 1,
    "limit": 10,
    "total": 137,
    "totalPages": 14
  }
}

{
  "statusCode": 401,
  "code": "UNAUTHORIZED",
  "message": "Invalid or expired credential",
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/vc/{connectionId}/customers/me/orders"
}

{
  "statusCode": 403,
  "code": "INSUFFICIENT_SCOPE",
  "message": "API key does not have the required scope: products:write",
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/vc/{connectionId}/customers/me/orders"
}

{
  "statusCode": 404,
  "code": "RESOURCE_NOT_FOUND",
  "message": "Resource not found",
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/vc/{connectionId}/customers/me/orders"
}

{
  "statusCode": 429,
  "code": "RATE_LIMITED",
  "message": "Too many requests",
  "details": {
    "retryAfterSeconds": 12
  },
  "timestamp": "2026-08-23T10:15:00.000Z",
  "path": "/api/vc/{connectionId}/customers/me/orders"
}