---
title: "Get an order"
method: GET
path: "/orders/{orderId}"
tags: ["Orders"]
---

# Get an order

`GET /orders/{orderId}`

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

## Path parameters

- `orderId` string, uuid, required

## Headers

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

## Response `200`

Get an order

- object
  - `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

## 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)