---
title: "List orders"
method: GET
path: "/orders"
tags: ["Orders"]
---

# List orders

`GET /orders`

**Beta** — this endpoint may change before general availability.

## Query parameters

- `projectId` string, uuid, required
- `cursor` string
- `limit` integer
- `financialStatus` 'pending' | 'paid' | 'failed' | 'refunded' | 'partiallyRefunded' — OrderFinancialStatus
- `customerEmail` string, email

## Headers

- `Replo-Api-Version` '2026-08-21', required

## Response `200`

List orders

- object
  - `object` 'list', required
  - `data` object[], required
    - `id` string, uuid, required
    - `createdAt` string, required
    - `customerEmail` string, nullable, required
    - `customerName` string, nullable, required
    - `financialStatus` string, required
    - `fulfillmentStatus` 'unfulfilled' | 'partial' | 'fulfilled' | 'cancelled', required — OrderItemFulfillmentStatus
    - `totalAmount` integer, required — Integer amount in the currency's minor units (Stripe convention): 1999 = $19.99 USD, 1999 = ¥1999 JPY, 1999 = 1.999 KWD
    - `currencyCode` string, required
    - `items` object[], required
      - `id` string, uuid, required
      - `variantId` string, uuid, required
      - `sku` string, nullable, required
      - `variantTitleSnapshot` string, required
      - `imageUrlSnapshot` string, nullable, required
      - `optionValuesSnapshot` object[], required — OrderItemOptionValuesSnapshot
        - `name` string, required
        - `value` string, required
      - `quantity` integer, required
      - `unitPrice` integer, required — Integer amount in the currency's minor units (Stripe convention): 1999 = $19.99 USD, 1999 = ¥1999 JPY, 1999 = 1.999 KWD
      - `totalPrice` integer, required — Integer amount in the currency's minor units (Stripe convention): 1999 = $19.99 USD, 1999 = ¥1999 JPY, 1999 = 1.999 KWD
    - `fulfillmentOrders` object[], required
      - `id` string, uuid, required
      - `orderId` string, uuid, required
      - `assignedLocationId` string, uuid, required
      - `status` 'open' | 'inProgress' | 'closed' | 'cancelled' | 'onHold' | 'incomplete' | 'scheduled', required — BedrockFulfillmentOrderStatus
      - `requestStatus` 'unsubmitted' | 'submitted' | 'accepted' | 'rejected' | 'cancellationRequested' | 'cancellationAccepted' | 'cancellationRejected' | 'closed', required — BedrockFulfillmentOrderRequestStatus
      - `lineItems` object[], required
        - `id` string, uuid, required
        - `orderItemId` string, uuid, required
        - `totalQuantity` integer, required
        - `remainingQuantity` integer, required
      - `fulfillments` object[], required
        - `id` string, uuid, required
        - `fulfillmentOrderId` string, uuid, required
        - `status` 'pending' | 'open' | 'success' | 'cancelled' | 'error' | 'failure', required — BedrockFulfillmentStatus
        - `trackingCarrier` string, nullable, required
        - `trackingNumber` string, nullable, required
        - `trackingUrl` string, nullable, required
        - `shippedAt` string, nullable, required
        - `deliveredAt` string, nullable, required
        - `lineItemQuantities` object[], required
          - `fulfillmentOrderLineItemId` string, uuid, required
          - `quantity` integer, required
        - `createdAt` string, required
      - `createdAt` string, required
    - `events` object[], required
      - `id` string, uuid, required
      - `orderId` string, uuid, required
      - `kind` string, required
      - `actor` union, required — OrderEventActor
        - object
          - `type` 'user', required
          - `userId` string, uuid, required
        - object
          - `type` 'agent', required
          - `userId` string, uuid, required
          - `agentSessionId` string, required
        - object
          - `type` 'system', required
        - object
          - `type` 'provider', required
          - `agentIntegrationConnectionId` string, uuid, required
          - `providerKey` string, required
      - `metadata` union, required — OrderEventMetadata
        - object
          - `kind` 'note', required
          - `markdown` string, required
        - object
          - `kind` 'paymentCaptured', required
          - `amount` integer, required — Integer amount in the currency's minor units (Stripe convention): 1999 = $19.99 USD, 1999 = ¥1999 JPY, 1999 = 1.999 KWD
          - `currencyCode` string, required
          - `stripePaymentIntentId` string, required
        - object
          - `kind` 'paymentFailed', required
          - `source` 'payment_intent.payment_failed' | 'charge.failed', required
          - `stripePaymentIntentId` string
          - `stripeChargeId` string
          - `stripeErrorCode` string
          - `stripeDeclineCode` string
          - `message` string
        - object
          - `kind` 'refundIssued', required
          - `amount` integer, required — Integer amount in the currency's minor units (Stripe convention): 1999 = $19.99 USD, 1999 = ¥1999 JPY, 1999 = 1.999 KWD
          - `currencyCode` string, required
          - `reason` 'duplicate' | 'fraudulent' | 'requested_by_customer' | 'expired_uncaptured_charge' | 'null', nullable — StripeRefundReason
          - `isFullRefund` boolean, required
        - object
          - `kind` 'fulfillmentOrderCreated', required
          - `fulfillmentOrderId` string, uuid, required
          - `itemCount` number, required
        - object
          - `kind` 'fulfillmentOrderSubmitted', required
          - `fulfillmentOrderId` string, uuid, required
          - `providerKey` string, required
          - `externalRef` string, required
        - object
          - `kind` 'fulfillmentOrderAccepted', required
          - `fulfillmentOrderId` string, uuid, required
          - `providerKey` string, required
        - object
          - `kind` 'fulfillmentOrderRejected', required
          - `fulfillmentOrderId` string, uuid, required
          - `providerKey` string, required
          - `reason` string, required
        - object
          - `kind` 'fulfillmentOrderHeld', required
          - `fulfillmentOrderId` string, uuid, required
          - `reason` string, required
          - `reasonNotes` string
        - object
          - `kind` 'fulfillmentOrderReleased', required
          - `fulfillmentOrderId` string, uuid, required
        - object
          - `kind` 'fulfillmentOrderIncomplete', required
          - `fulfillmentOrderId` string, uuid, required
          - `reason` string, required
        - object
          - `kind` 'fulfillmentOrderCancelled', required
          - `fulfillmentOrderId` string, uuid, required
          - `cancelledBy` 'merchant' | 'provider' | 'system', required
        - object
          - `kind` 'fulfillmentOrderCancellationRequested', required
          - `fulfillmentOrderId` string, uuid, required
        - object
          - `kind` 'shipmentCreated', required
          - `fulfillmentOrderId` string, uuid, required
          - `fulfillmentId` string, uuid, required
        - object
          - `kind` 'shipmentSent', required
          - `fulfillmentOrderId` string, uuid, required
          - `fulfillmentId` string, uuid, required
          - `trackingCarrier` string
          - `trackingNumber` string
          - `trackingUrl` string
        - object
          - `kind` 'shipmentDelivered', required
          - `fulfillmentOrderId` string, uuid, required
          - `fulfillmentId` string, uuid, required
        - object
          - `kind` 'shipmentReturned', required
          - `fulfillmentOrderId` string, uuid, required
          - `fulfillmentId` string, uuid, required
          - `reason` string
        - object
          - `kind` 'shipmentCancelled', required
          - `fulfillmentOrderId` string, uuid, required
          - `fulfillmentId` string, uuid, required
        - object
          - `kind` 'inventoryDecremented', required
          - `entries` object[], required
            - `variantId` string, uuid, required
            - `locationId` string, uuid, required
            - `delta` number, required
            - `before` number, required
            - `after` number, required
        - object
          - `kind` 'customerEmailSent', required
          - `templateType` 'order.confirmation' | 'order.fulfillment' | 'order.refund', required
          - `status` 'pending', required
        - object
          - `kind` 'customerEmailSent', required
          - `templateType` 'order.confirmation' | 'order.fulfillment' | 'order.refund', required
          - `status` 'sent', required
          - `to` string, required
          - `resendMessageId` string
        - object
          - `kind` 'customerEmailSent', required
          - `templateType` 'order.confirmation' | 'order.fulfillment' | 'order.refund', required
          - `status` 'failed', required
          - `to` string
        - object
          - `kind` 'customerEmailSent', required
          - `templateType` 'order.confirmation' | 'order.fulfillment' | 'order.refund', required
          - `status` 'skipped', required
          - `reason` 'noCustomerEmail', required
        - object
          - `kind` 'merchantNotificationSent', required
          - `status` 'pending', required
        - object
          - `kind` 'merchantNotificationSent', required
          - `status` 'sent', required
          - `to` string, required
          - `resendMessageId` string, required
        - object
          - `kind` 'merchantNotificationSent', required
          - `status` 'failed', required
          - `to` string, required
        - object
          - `kind` 'merchantNotificationSent', required
          - `status` 'skipped', required
      - `fulfillmentOrderId` string, uuid, nullable, required
      - `fulfillmentId` string, uuid, nullable, required
      - `createdAt` string, required
      - `editedAt` string, nullable, required
      - `deletedAt` string, nullable, required
    - `refundedAmount` integer, required — Integer amount in the currency's minor units (Stripe convention): 1999 = $19.99 USD, 1999 = ¥1999 JPY, 1999 = 1.999 KWD
    - `subtotalAmount` integer, required — Integer amount in the currency's minor units (Stripe convention): 1999 = $19.99 USD, 1999 = ¥1999 JPY, 1999 = 1.999 KWD
    - `taxAmount` integer, required — Integer amount in the currency's minor units (Stripe convention): 1999 = $19.99 USD, 1999 = ¥1999 JPY, 1999 = 1.999 KWD
    - `shippingAmount` integer, required — Integer amount in the currency's minor units (Stripe convention): 1999 = $19.99 USD, 1999 = ¥1999 JPY, 1999 = 1.999 KWD
    - `discountAmount` integer, required — Integer amount in the currency's minor units (Stripe convention): 1999 = $19.99 USD, 1999 = ¥1999 JPY, 1999 = 1.999 KWD
    - `stripePaymentIntentId` string, nullable, required
    - `object` 'order', required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400` — Invalid request.
- `401` — Missing or invalid Replo Public API token.
- `403` — You are not authorized to access this resource.
- `404` — Not Found
- `409` — The resource is in a conflicting state.
- `429` — Too many requests. Please retry after the time indicated by the Retry-After header.
- `500` — An internal error occurred.
- `503` — Service temporarily unavailable.

---

[API](https://skmtc.dev/replo/apis/replo-public-api.md) · [All operations](https://skmtc.dev/replo/apis/replo-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/replo/replo-public-api/revisions/6f031f6819f4/schema)