> ## Documentation Index
> Fetch the complete documentation index at: https://developers.redo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Order

> Retrieve an existing order from the system, including all fulfillments. The orderId parameter can be either the external order ID you provided when creating the order, or the internal Redo order ID returned from the create order response.



## OpenAPI

````yaml /api-schema/openapi.yaml get /stores/{storeId}/orders/{orderId}
openapi: 3.1.0
info:
  contact:
    email: engineering-admin@getredo.com
    name: Redo Engineering
  description: |
    ## Endpoints

    Endpoints are authenticated using the Bearer authorization scheme, using the
    REDO_API_SECRET.

    ```txt
    GET /v2.2/resource HTTP/1.1
    Authorization: Bearer 77bb7598b7a972475cc7c7e171ec33af
    Host: api.getredo.com
    ```

    ## Webhooks

    Webhooks are authenticated using the Bearer authorization scheme, using
    a secret supplied by the subscriber.

    ```txt
    POST /events HTTP/1.1
    Authorization: Bearer subscriberauth123
    Host: subscriber.example.com
    ```

    Webhook events are delivered in order for each individual subject (e.g.
    return).

    If the response is not a 2xx status code, the event will be retried multiple
    times before discarding it.
  title: Redo API
  version: 2.2.1
servers:
  - url: https://api.getredo.com/v2.2
security: []
tags:
  - name: Checkout Buttons
  - name: Coverage Info
  - name: Coverage Products
  - name: Custom Events
  - name: Customer Portal
  - name: Customer Subscriptions
  - name: Customers
  - name: Inbound Shipments
  - name: Inventory Items
  - name: Inventory Levels
  - name: Invoices
  - name: Merchant Admin
  - name: Orders
  - name: Products
  - name: Returns
  - name: Storefront
  - name: Webhooks
paths:
  /stores/{storeId}/orders/{orderId}:
    summary: Order
    description: Single order operations.
    parameters:
      - $ref: '#/components/parameters/store-id.param'
      - $ref: '#/components/parameters/order-id.param'
    get:
      tags:
        - Orders
      summary: Get Order
      description: >-
        Retrieve an existing order from the system, including all fulfillments.
        The orderId parameter can be either the external order ID you provided
        when creating the order, or the internal Redo order ID returned from the
        create order response.
      operationId: Order get
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/orders-api-get-order-response.schema'
          description: Success
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/orders-api-error.schema'
          description: Unauthorized (invalid or missing API token)
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/orders-api-error.schema'
          description: Order not found
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/error.schema'
          description: Error
      security:
        - Bearer: []
components:
  parameters:
    store-id.param:
      description: Store ID
      in: path
      name: storeId
      required: true
      schema:
        example: 64e5a8a1af49a89df37e4ee7
        type: string
    order-id.param:
      description: >-
        Order ID. Can be either the external order ID provided when creating the
        order, or the internal Redo order ID.
      in: path
      name: orderId
      required: true
      schema:
        type: string
  schemas:
    orders-api-get-order-response.schema:
      description: Response for getting an order, including fulfillments.
      allOf:
        - $ref: '#/components/schemas/orders-api-create-order-request.schema'
        - properties:
            fulfillments:
              description: List of fulfillments for this order.
              items:
                $ref: '#/components/schemas/orders-api-fulfillment.schema'
              type: array
          required:
            - fulfillments
          type: object
    orders-api-error.schema:
      description: Orders API error response.
      properties:
        error:
          description: Error message describing what went wrong.
          type: string
      required:
        - error
      type: object
    error.schema:
      description: >-
        Problem details. See [RFC 7807 Section
        3](https://datatracker.ietf.org/doc/html/rfc7807#section-3).
      properties:
        detail:
          description: Human-readable description of the problem.
          title: Detail
          type: string
        instance:
          description: A URI reference that identifies this problem.
          format: uri-reference
          type: string
        title:
          description: Human-readable summary of the problem type.
          title: Title
          type: string
        type:
          default: about:blank
          description: A URI reference that identifies the problem type.
          format: uri-reference
          type: string
      title: Problem details
      type: object
    orders-api-create-order-request.schema:
      description: Request body for creating an order.
      properties:
        orderId:
          description: Unique identifier for the order.
          type: string
        createdAt:
          description: ISO 8601 date string for when the order was created.
          format: date-time
          type: string
        lineItems:
          description: List of line items in the order.
          items:
            $ref: '#/components/schemas/orders-api-line-item.schema'
          minItems: 1
          type: array
        customer:
          $ref: '#/components/schemas/orders-api-customer.schema'
        shipping:
          $ref: '#/components/schemas/orders-api-shipping.schema'
        totalPrice:
          description: >-
            Total order price including tax and shipping, as a decimal amount in
            the order's currency (e.g. $79.99, not 7999 cents).
          minimum: 0
          type:
            - number
            - 'null'
        subtotalPrice:
          description: >-
            Subtotal price excluding tax and shipping, as a decimal amount in
            the order's currency (e.g. $79.99, not 7999 cents).
          minimum: 0
          type:
            - number
            - 'null'
        totalTax:
          description: >-
            Total tax amount, as a decimal amount in the order's currency (e.g.
            $79.99, not 7999 cents).
          minimum: 0
          type:
            - number
            - 'null'
        totalDiscount:
          description: >-
            Total discount amount applied to the order (e.g. coupon codes,
            promotions), as a decimal amount in the order's currency (e.g.
            $79.99, not 7999 cents).
          minimum: 0
          type:
            - number
            - 'null'
        billingAddress:
          $ref: '#/components/schemas/orders-api-billing-address.schema'
        tags:
          description: Optional tags associated with the order.
          items:
            type: string
          type:
            - array
            - 'null'
        currencyCode:
          description: Currency code from the ISO 4217 standard (e.g., USD, EUR, GBP).
          type:
            - string
            - 'null'
        locationId:
          description: >-
            Optional. Pin this order to a specific fulfillment location. Must be
            a location id (`loc_...`) returned by `GET /inventory-levels` —
            either one of your own warehouses or a location at a linked 3PL
            fulfillment service. When provided, the fulfillment group's origin
            address is sourced from the location row. Omit to use your team's
            default origin address.
          example: loc_4d8e1a2b3c
          type:
            - string
            - 'null'
      required:
        - orderId
        - createdAt
        - lineItems
      type: object
    orders-api-fulfillment.schema:
      description: Fulfillment information.
      properties:
        id:
          description: Unique fulfillment ID.
          type: string
        createdAt:
          description: ISO 8601 date string for when the fulfillment was created.
          format: date-time
          type: string
        lineItems:
          description: List of line items in this fulfillment.
          items:
            $ref: '#/components/schemas/orders-api-fulfillment-line-item.schema'
          type: array
        trackingCompany:
          description: Shipping carrier name (e.g., FedEx, UPS).
          type:
            - string
            - 'null'
        trackingNumber:
          description: Tracking number for the shipment.
          type:
            - string
            - 'null'
        status:
          description: Current shipment status.
          enum:
            - pre_transit
            - unknown
            - in_transit
            - out_for_delivery
            - available_for_pickup
            - delivered
            - return_to_sender
            - failure
            - cancelled
            - error
          type: string
        estimatedDeliveryDate:
          description: >-
            Carrier's estimated delivery date (YYYY-MM-DD), typically in the
            destination's local time. Some carriers do not clearly distinguish
            local vs UTC, so the date may occasionally be off by one day.
          pattern: ^\d{4}-\d{2}-\d{2}$
          type:
            - string
            - 'null'
        deliveredAt:
          description: ISO 8601 timestamp of when the shipment was delivered.
          format: date-time
          type:
            - string
            - 'null'
        trackingHistory:
          description: List of tracking events in chronological order.
          items:
            $ref: '#/components/schemas/orders-api-tracking-event.schema'
          type: array
      required:
        - id
        - createdAt
        - lineItems
        - status
        - trackingHistory
      type: object
    orders-api-line-item.schema:
      description: Line item in the order.
      properties:
        id:
          description: Unique identifier for the line item.
          type: string
        productId:
          description: Identifier for the product.
          type: string
        variantId:
          description: Identifier for the product variant.
          type:
            - string
            - 'null'
        title:
          description: Title/name of the product.
          type: string
        sku:
          description: SKU of the product.
          type:
            - string
            - 'null'
        quantity:
          description: Quantity of the product ordered.
          minimum: 1
          maximum: 1000
          type: integer
        price:
          description: >-
            Price per unit of the product before discounts, as a decimal amount
            in the order's currency (e.g. $79.99, not 7999 cents).
          minimum: 0
          type:
            - number
            - 'null'
        imageUrl:
          description: URL to the product image.
          maxLength: 2048
          type:
            - string
            - 'null'
        discount:
          description: >-
            Total discount amount applied to this line item, as a decimal amount
            in the order's currency (e.g. $79.99, not 7999 cents).
          minimum: 0
          type:
            - number
            - 'null'
      required:
        - id
        - productId
        - title
        - quantity
      type: object
    orders-api-customer.schema:
      description: Customer information.
      properties:
        id:
          description: Customer ID from the external system.
          type:
            - string
            - 'null'
        email:
          description: Customer email address.
          type:
            - string
            - 'null'
        phoneNumber:
          description: Customer phone number.
          type:
            - string
            - 'null'
        name:
          description: Customer full name.
          type:
            - string
            - 'null'
        firstName:
          description: Customer first name.
          type:
            - string
            - 'null'
        lastName:
          description: Customer last name.
          type:
            - string
            - 'null'
      type: object
    orders-api-shipping.schema:
      description: Shipping information.
      properties:
        method:
          description: Shipping method name.
          type:
            - string
            - 'null'
        cost:
          description: >-
            Shipping cost, as a decimal amount in the order's currency (e.g.
            $79.99, not 7999 cents).
          minimum: 0
          type:
            - number
            - 'null'
        address:
          $ref: '#/components/schemas/orders-api-shipping-address.schema'
      type: object
    orders-api-billing-address.schema:
      description: Billing address.
      properties:
        address1:
          description: Primary address line.
          type:
            - string
            - 'null'
        address2:
          description: Secondary address line.
          type:
            - string
            - 'null'
        city:
          description: City.
          type:
            - string
            - 'null'
        province:
          description: State or province.
          type:
            - string
            - 'null'
        country:
          description: Country.
          type:
            - string
            - 'null'
        postalCode:
          description: Postal or zip code.
          type:
            - string
            - 'null'
      type: object
    orders-api-fulfillment-line-item.schema:
      description: Fulfilled line item details.
      properties:
        id:
          description: Line item ID that was fulfilled.
          type: string
        quantity:
          description: Quantity fulfilled for this line item.
          minimum: 1
          maximum: 1000
          type: integer
        title:
          description: Title/name of the product.
          type: string
        productId:
          description: Product ID.
          type: string
        variantId:
          description: Product variant ID.
          type:
            - string
            - 'null'
        sku:
          description: SKU of the product.
          type:
            - string
            - 'null'
      required:
        - id
        - quantity
        - title
        - productId
      type: object
    orders-api-tracking-event.schema:
      description: Tracking event details.
      properties:
        message:
          description: Tracking event message.
          type: string
        status:
          description: Status at this tracking event.
          type: string
        datetime:
          description: ISO 8601 timestamp of the tracking event.
          format: date-time
          type: string
        location:
          $ref: '#/components/schemas/orders-api-tracking-location.schema'
      required:
        - message
        - status
        - datetime
      type: object
    orders-api-shipping-address.schema:
      description: Shipping address.
      properties:
        address1:
          description: Primary address line.
          type:
            - string
            - 'null'
        address2:
          description: Secondary address line.
          type:
            - string
            - 'null'
        city:
          description: City.
          type:
            - string
            - 'null'
        province:
          description: State or province.
          type:
            - string
            - 'null'
        country:
          description: Country.
          type:
            - string
            - 'null'
        postalCode:
          description: Postal or zip code.
          type:
            - string
            - 'null'
      type: object
    orders-api-tracking-location.schema:
      description: Location information for a tracking event.
      properties:
        city:
          type:
            - string
            - 'null'
        state:
          type:
            - string
            - 'null'
        country:
          type:
            - string
            - 'null'
        postalCode:
          type:
            - string
            - 'null'
      type: object
  securitySchemes:
    Bearer:
      scheme: bearer
      type: http

````