> ## Documentation Index
> Fetch the complete documentation index at: https://beta.docs.replo.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Get an order

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



## OpenAPI

````yaml /api-reference/openapi.json get /orders/{orderId}
openapi: 3.1.0
info:
  title: Replo Public API
  version: '2026-06-27'
servers:
  - url: https://public-api.replo.app/api/v1/public
security: []
paths:
  /orders/{orderId}:
    get:
      tags:
        - Orders
      summary: Get an order
      description: '**Beta** — this endpoint may change before general availability.'
      operationId: orders.get
      parameters:
        - name: Replo-Api-Version
          in: header
          required: true
          schema:
            type: string
            enum:
              - '2026-06-27'
          description: The public API version to use for this request.
        - schema:
            type: string
            format: uuid
          required: true
          name: orderId
          in: path
      responses:
        '200':
          description: Get an order
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                  createdAt:
                    type: string
                  customerEmail:
                    type:
                      - string
                      - 'null'
                  financialStatus:
                    type: string
                  fulfillmentStatus:
                    type: string
                    enum:
                      - unfulfilled
                      - partial
                      - fulfilled
                      - cancelled
                    description: OrderItemFulfillmentStatus
                  totalAmount:
                    type: string
                  currencyCode:
                    type: string
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        variantId:
                          type: string
                          format: uuid
                        sku:
                          type:
                            - string
                            - 'null'
                        titleSnapshot:
                          type: string
                        optionValuesSnapshot:
                          type: array
                          items:
                            type: object
                            properties:
                              name:
                                type: string
                              value:
                                type: string
                            required:
                              - name
                              - value
                            description: OrderItemOptionValue
                          description: OrderItemOptionValuesSnapshot
                        quantity:
                          type: integer
                        unitPrice:
                          type: string
                        totalPrice:
                          type: string
                      required:
                        - id
                        - variantId
                        - sku
                        - titleSnapshot
                        - optionValuesSnapshot
                        - quantity
                        - unitPrice
                        - totalPrice
                      description: BedrockOrderItem
                  fulfillmentOrders:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        orderId:
                          type: string
                          format: uuid
                        assignedLocationId:
                          type: string
                          format: uuid
                        status:
                          type: string
                          enum:
                            - open
                            - inProgress
                            - closed
                            - cancelled
                            - onHold
                            - incomplete
                            - scheduled
                          description: BedrockFulfillmentOrderStatus
                        requestStatus:
                          type: string
                          enum:
                            - unsubmitted
                            - submitted
                            - accepted
                            - rejected
                            - cancellationRequested
                            - cancellationAccepted
                            - cancellationRejected
                            - closed
                          description: BedrockFulfillmentOrderRequestStatus
                        lineItems:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                              orderItemId:
                                type: string
                                format: uuid
                              totalQuantity:
                                type: integer
                              remainingQuantity:
                                type: integer
                            required:
                              - id
                              - orderItemId
                              - totalQuantity
                              - remainingQuantity
                            description: BedrockFulfillmentOrderLineItem
                        fulfillments:
                          type: array
                          items:
                            type: object
                            properties:
                              id:
                                type: string
                                format: uuid
                              status:
                                type: string
                                enum:
                                  - pending
                                  - open
                                  - success
                                  - cancelled
                                  - error
                                  - failure
                                description: BedrockFulfillmentStatus
                              trackingCarrier:
                                type:
                                  - string
                                  - 'null'
                              trackingNumber:
                                type:
                                  - string
                                  - 'null'
                              trackingUrl:
                                type:
                                  - string
                                  - 'null'
                              shippedAt:
                                type:
                                  - string
                                  - 'null'
                              deliveredAt:
                                type:
                                  - string
                                  - 'null'
                              lineItemQuantities:
                                type: array
                                items:
                                  type: object
                                  properties:
                                    fulfillmentOrderLineItemId:
                                      type: string
                                      format: uuid
                                    quantity:
                                      type: integer
                                  required:
                                    - fulfillmentOrderLineItemId
                                    - quantity
                              createdAt:
                                type: string
                            required:
                              - id
                              - status
                              - trackingCarrier
                              - trackingNumber
                              - trackingUrl
                              - shippedAt
                              - deliveredAt
                              - lineItemQuantities
                              - createdAt
                            description: BedrockFulfillment
                        createdAt:
                          type: string
                      required:
                        - id
                        - orderId
                        - assignedLocationId
                        - status
                        - requestStatus
                        - lineItems
                        - fulfillments
                        - createdAt
                      description: BedrockFulfillmentOrder
                  events:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        orderId:
                          type: string
                          format: uuid
                        kind:
                          type: string
                        actor:
                          oneOf:
                            - type: object
                              properties:
                                type:
                                  type: string
                                  enum:
                                    - user
                                userId:
                                  type: string
                                  format: uuid
                              required:
                                - type
                                - userId
                            - type: object
                              properties:
                                type:
                                  type: string
                                  enum:
                                    - agent
                                userId:
                                  type: string
                                  format: uuid
                                agentSessionId:
                                  type: string
                              required:
                                - type
                                - userId
                                - agentSessionId
                            - type: object
                              properties:
                                type:
                                  type: string
                                  enum:
                                    - system
                              required:
                                - type
                            - type: object
                              properties:
                                type:
                                  type: string
                                  enum:
                                    - provider
                                agentIntegrationConnectionId:
                                  type: string
                                  format: uuid
                                providerKey:
                                  type: string
                              required:
                                - type
                                - agentIntegrationConnectionId
                                - providerKey
                          description: OrderEventActor
                        metadata:
                          oneOf:
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - note
                                markdown:
                                  type: string
                              required:
                                - kind
                                - markdown
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - paymentCaptured
                                amount:
                                  type: string
                                currencyCode:
                                  type: string
                                stripePaymentIntentId:
                                  type: string
                              required:
                                - kind
                                - amount
                                - currencyCode
                                - stripePaymentIntentId
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - paymentFailed
                                source:
                                  type: string
                                  enum:
                                    - checkout.session.async_payment_failed
                                    - payment_intent.payment_failed
                                    - charge.failed
                                stripePaymentIntentId:
                                  type: string
                                stripeChargeId:
                                  type: string
                                stripeErrorCode:
                                  type: string
                                stripeDeclineCode:
                                  type: string
                                message:
                                  type: string
                              required:
                                - kind
                                - source
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - refundIssued
                                amount:
                                  type: string
                                currencyCode:
                                  type: string
                                reason:
                                  type:
                                    - string
                                    - 'null'
                                  enum:
                                    - duplicate
                                    - fraudulent
                                    - requested_by_customer
                                    - expired_uncaptured_charge
                                    - null
                                  description: StripeRefundReason
                                isFullRefund:
                                  type: boolean
                              required:
                                - kind
                                - amount
                                - currencyCode
                                - isFullRefund
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - fulfillmentOrderCreated
                                fulfillmentOrderId:
                                  type: string
                                  format: uuid
                                itemCount:
                                  type: number
                              required:
                                - kind
                                - fulfillmentOrderId
                                - itemCount
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - fulfillmentOrderSubmitted
                                fulfillmentOrderId:
                                  type: string
                                  format: uuid
                                providerKey:
                                  type: string
                                externalRef:
                                  type: string
                              required:
                                - kind
                                - fulfillmentOrderId
                                - providerKey
                                - externalRef
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - fulfillmentOrderAccepted
                                fulfillmentOrderId:
                                  type: string
                                  format: uuid
                                providerKey:
                                  type: string
                              required:
                                - kind
                                - fulfillmentOrderId
                                - providerKey
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - fulfillmentOrderRejected
                                fulfillmentOrderId:
                                  type: string
                                  format: uuid
                                providerKey:
                                  type: string
                                reason:
                                  type: string
                              required:
                                - kind
                                - fulfillmentOrderId
                                - providerKey
                                - reason
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - fulfillmentOrderHeld
                                fulfillmentOrderId:
                                  type: string
                                  format: uuid
                                reason:
                                  type: string
                                reasonNotes:
                                  type: string
                              required:
                                - kind
                                - fulfillmentOrderId
                                - reason
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - fulfillmentOrderReleased
                                fulfillmentOrderId:
                                  type: string
                                  format: uuid
                              required:
                                - kind
                                - fulfillmentOrderId
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - fulfillmentOrderIncomplete
                                fulfillmentOrderId:
                                  type: string
                                  format: uuid
                                reason:
                                  type: string
                              required:
                                - kind
                                - fulfillmentOrderId
                                - reason
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - fulfillmentOrderCancelled
                                fulfillmentOrderId:
                                  type: string
                                  format: uuid
                                cancelledBy:
                                  type: string
                                  enum:
                                    - merchant
                                    - provider
                                    - system
                              required:
                                - kind
                                - fulfillmentOrderId
                                - cancelledBy
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - fulfillmentOrderCancellationRequested
                                fulfillmentOrderId:
                                  type: string
                                  format: uuid
                              required:
                                - kind
                                - fulfillmentOrderId
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - shipmentCreated
                                fulfillmentOrderId:
                                  type: string
                                  format: uuid
                                fulfillmentId:
                                  type: string
                                  format: uuid
                              required:
                                - kind
                                - fulfillmentOrderId
                                - fulfillmentId
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - shipmentSent
                                fulfillmentOrderId:
                                  type: string
                                  format: uuid
                                fulfillmentId:
                                  type: string
                                  format: uuid
                                trackingCarrier:
                                  type: string
                                trackingNumber:
                                  type: string
                                trackingUrl:
                                  type: string
                              required:
                                - kind
                                - fulfillmentOrderId
                                - fulfillmentId
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - shipmentDelivered
                                fulfillmentOrderId:
                                  type: string
                                  format: uuid
                                fulfillmentId:
                                  type: string
                                  format: uuid
                              required:
                                - kind
                                - fulfillmentOrderId
                                - fulfillmentId
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - shipmentReturned
                                fulfillmentOrderId:
                                  type: string
                                  format: uuid
                                fulfillmentId:
                                  type: string
                                  format: uuid
                                reason:
                                  type: string
                              required:
                                - kind
                                - fulfillmentOrderId
                                - fulfillmentId
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - shipmentCancelled
                                fulfillmentOrderId:
                                  type: string
                                  format: uuid
                                fulfillmentId:
                                  type: string
                                  format: uuid
                              required:
                                - kind
                                - fulfillmentOrderId
                                - fulfillmentId
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - inventoryDecremented
                                entries:
                                  type: array
                                  items:
                                    type: object
                                    properties:
                                      variantId:
                                        type: string
                                        format: uuid
                                      locationId:
                                        type: string
                                        format: uuid
                                      delta:
                                        type: number
                                      before:
                                        type: number
                                      after:
                                        type: number
                                    required:
                                      - variantId
                                      - locationId
                                      - delta
                                      - before
                                      - after
                              required:
                                - kind
                                - entries
                            - type: object
                              properties:
                                kind:
                                  type: string
                                  enum:
                                    - customerEmailSent
                                template:
                                  type: string
                                  enum:
                                    - stripeReceipt
                                    - fulfillmentWithDownloads
                                    - manualFulfillmentTracking
                                    - asyncPaymentFailed
                                to:
                                  type: string
                                stripePaymentIntentId:
                                  type: string
                                stripeChargeId:
                                  type: string
                                fulfillmentId:
                                  type: string
                                  format: uuid
                              required:
                                - kind
                                - template
                                - to
                          description: OrderEventMetadata
                        fulfillmentOrderId:
                          type:
                            - string
                            - 'null'
                          format: uuid
                        fulfillmentId:
                          type:
                            - string
                            - 'null'
                          format: uuid
                        createdAt:
                          type: string
                        editedAt:
                          type:
                            - string
                            - 'null'
                        deletedAt:
                          type:
                            - string
                            - 'null'
                      required:
                        - id
                        - orderId
                        - kind
                        - actor
                        - metadata
                        - fulfillmentOrderId
                        - fulfillmentId
                        - createdAt
                        - editedAt
                        - deletedAt
                      description: BedrockOrderEvent
                  refundedAmount:
                    type: string
                  subtotalAmount:
                    type: string
                  taxAmount:
                    type: string
                  shippingAmount:
                    type: string
                  discountAmount:
                    type: string
                  stripePaymentIntentId:
                    type:
                      - string
                      - 'null'
                  object:
                    type: string
                    enum:
                      - order
                required:
                  - id
                  - createdAt
                  - customerEmail
                  - financialStatus
                  - fulfillmentStatus
                  - totalAmount
                  - currencyCode
                  - items
                  - fulfillmentOrders
                  - events
                  - refundedAmount
                  - subtotalAmount
                  - taxAmount
                  - shippingAmount
                  - discountAmount
                  - stripePaymentIntentId
                  - object
                additionalProperties: false
        '400':
          description: Invalid request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '401':
          description: Missing or invalid Replo Public API token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '403':
          description: You are not authorized to access this resource.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '500':
          description: An internal error occurred.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
        '503':
          description: Service temporarily unavailable.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PublicApiError'
      security:
        - bearerAuth: []
components:
  schemas:
    PublicApiError:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
            doc_url:
              type: string
          required:
            - code
            - message
            - doc_url
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````