> ## 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. # List orders > **Beta** — this endpoint may change before general availability. ## OpenAPI ````yaml /api-reference/openapi.json get /orders 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: get: tags: - Orders summary: List orders description: '**Beta** — this endpoint may change before general availability.' operationId: orders.list 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: projectId in: query - schema: type: string minLength: 1 maxLength: 200 required: false name: cursor in: query - schema: type: integer exclusiveMinimum: 0 maximum: 100 required: false name: limit in: query - schema: type: string enum: - pending - paid - failed - refunded - partiallyRefunded description: OrderFinancialStatus required: false description: OrderFinancialStatus name: financialStatus in: query - schema: type: string format: email required: false name: customerEmail in: query responses: '200': description: List orders content: application/json: schema: type: object properties: object: type: string enum: - list data: type: array items: 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 has_more: type: boolean next_cursor: type: - string - 'null' required: - object - data - has_more - next_cursor '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 ````