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

# Get shipments for an order

> Retrieve all shipments related to a specific order.



## OpenAPI

````yaml dropship_shipments.openapi get /v1/retailers/{retailer_id}/orders/{id}/shipments/
openapi: 3.0.0
info:
  title: Shipments API
  version: 1.0.0
  description: >
    APIs for listing, retrieving, and acknowledging shipment and fulfillment
    records.
servers:
  - url: https://marketplace-api.fabric.inc
    description: Production server
security:
  - Bearer: []
tags:
  - name: Shipments
    description: Shipment management
paths:
  /v1/retailers/{retailer_id}/orders/{id}/shipments/:
    get:
      tags:
        - Shipments
      summary: Get shipments for an order
      description: Retrieve all shipments related to a specific order.
      parameters:
        - name: retailer_id
          in: path
          required: true
          description: >-
            The unique retailer ID. In the Dropship UI this is called the
            **Merchant ID**. To find your Merchant ID, click your merchant name
            in the top nav.
          schema:
            type: integer
        - name: id
          in: path
          required: true
          description: >-
            The unique order ID. This ID is generated when a new order is
            created.
          schema:
            type: integer
      responses:
        '200':
          description: Shipments for the order
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/RetailerOrder'
components:
  schemas:
    RetailerOrder:
      type: object
      required:
        - purchase_order_number
        - retailer_order_number
        - ordered_at
      properties:
        id:
          description: Unique identifier for the shipment record
          example: 12345
          type: integer
          readOnly: true
        customer_order_number:
          description: Customer's order reference number
          example: CUST-00123
          maxLength: 64
          type: string
          nullable: true
        purchase_order_number:
          description: Purchase order number assigned by the retailer
          example: PO-45678
          minLength: 1
          type: string
        retailer_order_number:
          description: Retailer's internal order number
          example: RET-89012
          minLength: 1
          type: string
        brand_identifier:
          description: Identifier used to specify the brand associated with the shipment
          example: BRD-001
          maxLength: 64
          type: string
          nullable: true
        retailer:
          description: Name of the retailer
          example: Retailer X
          type: string
          readOnly: true
        brand:
          description: Primary brand involved in the order
          example: Brand A
          type: string
          readOnly: true
        brands:
          description: Comma-separated list of brands in the order
          example: Brand A, Brand B
          type: string
          readOnly: true
        connection_id:
          description: Unique identifier for the platform connection
          example: 101
          type: integer
        shipping_method:
          description: Shipping method used for the order
          example: FedEx Ground
          type: string
          readOnly: true
        requested_shipping_method_id:
          description: ID of the requested shipping method
          example: 5
          type: integer
        requested_shipping_method:
          description: Requested shipping method name
          example: UPS 2nd Day Air
          type: string
          readOnly: true
        shipment_count:
          description: Total number of shipments associated with this order
          example: 3
          type: integer
          readOnly: true
        invoice_count:
          description: Total number of invoices associated with the order
          example: 2
          type: integer
          readOnly: true
        bill_to:
          description: Billing recipient
          example: Acme Corp
          type: string
          readOnly: true
        sold_to:
          description: Customer entity who made the purchase
          example: Acme Corp
          type: string
          readOnly: true
        ship_to:
          description: Shipping destination
          example: 123 Warehouse Ave
          type: string
          readOnly: true
        ship_from:
          description: Shipping origin
          example: 456 Supplier Rd
          type: string
          readOnly: true
        return_to:
          description: Return shipping address
          example: 789 Return Ln
          type: string
          readOnly: true
        allow_shipping_label_generation:
          description: Indicates if the platform allows label generation
          example: true
          type: boolean
        subtotal_charged:
          description: Subtotal charged for the order
          example: '99.99'
          type: string
          readOnly: true
        shipping_charged:
          description: Shipping charges applied to the order
          example: '10.00'
          type: string
        is_gift:
          description: Indicates if the shipment is a gift
          example: false
          type: boolean
        gift_fee:
          description: Fee associated with gift wrapping
          example: '5.00'
          type: string
          nullable: true
        is_replacement:
          description: Indicates if this shipment is a replacement
          example: false
          type: boolean
        locale_subtotal_charged:
          description: Subtotal charged in local currency
          example: '89.99'
          type: string
          readOnly: true
        status:
          description: Current status of the shipment
          example: processing
          minLength: 1
          type: string
          readOnly: true
        locale_currency:
          description: Local currency code
          example: EUR
          type: string
          readOnly: true
        currency:
          description: Currency code of the transaction
          example: USD
          type: string
          readOnly: true
        is_acknowledged:
          description: Whether the shipment has been acknowledged
          example: true
          type: boolean
          readOnly: true
        ordered_at:
          description: Date and time when the order was placed
          example: '2024-03-15T08:00:00.000Z'
          type: string
          format: date-time
        acknowledged_at:
          description: When the shipment was acknowledged
          example: '2024-03-16T08:00:00.000Z'
          type: string
          format: date-time
          nullable: true
        fulfill_by:
          description: Deadline to fulfill the shipment
          example: '2024-03-20T00:00:00.000Z'
          type: string
          readOnly: true
        fulfilled_at:
          description: Time the order was fulfilled
          example: '2024-03-19T08:00:00.000Z'
          type: string
          format: date-time
          nullable: true
        closed_at:
          description: When the shipment was closed
          example: '2024-03-21T08:00:00.000Z'
          type: string
          format: date-time
          readOnly: true
        received_at:
          description: Date the shipment was received
          example: '2024-03-22T08:00:00.000Z'
          type: string
          format: date-time
          readOnly: true
        is_on_hold:
          description: Whether the shipment is on hold
          example: false
          type: boolean
          readOnly: true
        pickup_on:
          description: Scheduled pickup date
          example: '2024-03-25T00:00:00.000Z'
          type: string
          format: date
          nullable: true
        on_hold_at:
          description: Timestamp when the shipment was put on hold
          example: '2024-03-24T08:00:00.000Z'
          type: string
          format: date-time
          nullable: true
        on_hold_until:
          description: Date until which the shipment is on hold
          example: '2024-03-30T00:00:00.000Z'
          type: string
          format: date
          nullable: true
        backordered_until:
          description: Date until backorder is expected
          example: '2024-04-01T08:00:00.000Z'
          type: string
          format: date-time
          nullable: true
        backorder_acknowledged_at:
          description: Date backorder was acknowledged
          example: '2024-03-28T08:00:00.000Z'
          type: string
          format: date-time
          nullable: true
        canceled_at:
          description: Date and time the shipment was canceled
          example: '2024-03-29T08:00:00.000Z'
          type: string
          format: date-time
          nullable: true
        updated_at:
          description: Timestamp of the last update
          example: '2024-04-01T12:00:00.000Z'
          type: string
          format: date-time
          readOnly: true
          nullable: true
        order_lines:
          description: List of order lines in the shipment
          example: '[...]'
          type: string
          readOnly: true
        cancels:
          description: Information about canceled items
          example: '[...]'
          type: string
          readOnly: true
        shipments:
          description: Shipment information
          example: '[...]'
          type: string
          readOnly: true
        attachments:
          description: Associated documents
          example: '[...]'
          type: string
          readOnly: true
        memos:
          description: List of memos attached to the order
          example: Memo 1
          type: string
          readOnly: true
        memos_count:
          description: Count of memos attached to the order
          example: 1
          type: string
          readOnly: true
        unread_memos_count:
          description: Count of unread memos
          example: 0
          type: string
          readOnly: true
        tags:
          description: Tags associated with the shipment
          example: Priority
          type: string
          readOnly: true
        gift_message:
          description: Gift message included with the order
          example: Happy Birthday!
          type: string
          readOnly: true
        fill_time:
          description: Estimated fill time for the order
          example: '48.00'
          type: string
          nullable: true
        invoices:
          description: Invoice details
          example: '[...]'
          type: string
          readOnly: true
        signature:
          description: Signature requirements for the delivery
          example: required
          type: string
          enum:
            - required
            - not_required
            - adult
          nullable: true
        rmas:
          description: Return merchandise authorizations
          example: '[...]'
          type: string
          readOnly: true
        credits:
          description: Credit notes issued for the order
          example: '[...]'
          type: string
          readOnly: true
        order_batches:
          description: Batches associated with the order
          example: '[...]'
          type: string
          readOnly: true
        metadata:
          description: Additional metadata related to the order
          example: '[...]'
          type: string
          readOnly: true
        connection_shipping_provider_account:
          description: Shipping provider account associated with the connection
          example: USPS-Conn-01
          type: string
          readOnly: true
        is_priority:
          description: Indicates whether the order is prioritized
          example: true
          type: boolean
        priority_user:
          description: User who prioritized the order
          example: admin@example.com
          type: string
          readOnly: true
        envelopes:
          description: Envelope details for the order
          example: Envelope A
          type: string
          readOnly: true
        platform_account_transactions:
          description: Related platform account transactions
          example: '[...]'
          type: string
          readOnly: true
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer

````