Skip to main content
GET
/
orders
List orders
curl --request GET \
  --url https://public-api.replo.app/api/v1/public/orders \
  --header 'Authorization: Bearer <token>' \
  --header 'Replo-Api-Version: <replo-api-version>'
{
  "object": "list",
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "createdAt": "<string>",
      "customerEmail": "<string>",
      "financialStatus": "<string>",
      "totalAmount": "<string>",
      "currencyCode": "<string>",
      "items": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "variantId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "sku": "<string>",
          "titleSnapshot": "<string>",
          "optionValuesSnapshot": [
            {
              "name": "<string>",
              "value": "<string>"
            }
          ],
          "quantity": 123,
          "unitPrice": "<string>",
          "totalPrice": "<string>"
        }
      ],
      "fulfillmentOrders": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "orderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "assignedLocationId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "lineItems": [
            {
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "orderItemId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "totalQuantity": 123,
              "remainingQuantity": 123
            }
          ],
          "fulfillments": [
            {
              "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
              "trackingCarrier": "<string>",
              "trackingNumber": "<string>",
              "trackingUrl": "<string>",
              "shippedAt": "<string>",
              "deliveredAt": "<string>",
              "lineItemQuantities": [
                {
                  "fulfillmentOrderLineItemId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
                  "quantity": 123
                }
              ],
              "createdAt": "<string>"
            }
          ],
          "createdAt": "<string>"
        }
      ],
      "events": [
        {
          "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "orderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "kind": "<string>",
          "actor": {
            "type": "user",
            "userId": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
          },
          "metadata": {
            "kind": "note",
            "markdown": "<string>"
          },
          "fulfillmentOrderId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "fulfillmentId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
          "createdAt": "<string>",
          "editedAt": "<string>",
          "deletedAt": "<string>"
        }
      ],
      "refundedAmount": "<string>",
      "subtotalAmount": "<string>",
      "taxAmount": "<string>",
      "shippingAmount": "<string>",
      "discountAmount": "<string>",
      "stripePaymentIntentId": "<string>",
      "object": "order"
    }
  ],
  "has_more": true,
  "next_cursor": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

Replo-Api-Version
enum<string>
required

The public API version to use for this request.

Available options:
2026-06-27

Query Parameters

projectId
string<uuid>
required
cursor
string
Required string length: 1 - 200
limit
integer
Required range: x <= 100
financialStatus
enum<string>

OrderFinancialStatus

Available options:
pending,
paid,
failed,
refunded,
partiallyRefunded
customerEmail
string<email>

Response

List orders

object
enum<string>
required
Available options:
list
data
object[]
required
has_more
boolean
required
next_cursor
string | null
required