> ## Documentation Index > Fetch the complete documentation index at: https://skulabs.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Shipments - Get > Retrieve shipments for a specific order. ## OpenAPI ````yaml get /shipments/get openapi: 3.0.3 info: title: SKULabs API description: >- Most API keys have "platformGeneric" and "platformApi" scopes included. Contact us to convert more routes from "platformUser" (only available to users) to "platformGeneric" (available to users and api keys) upon request. version: 4.5.0 servers: - url: https://api.skulabs.com - url: https://app.skulabs.com/s security: [] tags: - name: batch - name: customer description: Manage customers, tags, and notes - name: cycle_count - name: distributor - name: inventory description: Query and modify inventory levels across locations - name: inventory_table - name: item description: Manage items, barcodes, serial numbers, and tags - name: kit description: Manage kits and their component items - name: listing - name: location - name: oauth - name: order description: Manage orders, shipments, tags, and statuses - name: purchase_order description: Manage purchase orders and receiving - name: run - name: shipments - name: shipping - name: store - name: tag description: Create, update, and remove tags - name: transfer_order - name: warehouse description: Manage warehouses and view statistics - name: webhook description: Manage webhook handlers paths: /shipments/get: get: tags: - shipments summary: Shipments - Get description: Retrieve shipments for a specific order. operationId: get_shipments_get parameters: - name: selector in: query required: true schema: type: object properties: {} description: Query selector object for filtering results - name: limit in: query required: false schema: type: number description: Max results to return example: 50 - name: skip in: query required: false schema: type: number description: Number of results to skip example: 0 - name: sort in: query required: false schema: type: object properties: {} description: 'Sort fields object, e.g. { "name": 1 }' responses: '200': description: Array of shipments matching the query (flattened from orders) content: application/json: schema: type: array items: $ref: '#/components/schemas/Shipment' '400': description: Bad request content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: Detailed error message code: type: string description: Machine-readable error code overview: type: string description: Short human-friendly description statusCode: type: number description: HTTP status code origin: type: string description: Error source skulabsTraceId: type: string description: Trace ID for support type: type: string enum: - error - notice - success description: Error severity for UI handling user_error: type: boolean description: Whether the error was caused by user input display: type: string enum: - notification - panel description: Suggested UI display mode for the error required: - message - statusCode required: - error '401': description: Unauthorized content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: Detailed error message code: type: string description: Machine-readable error code overview: type: string description: Short human-friendly description statusCode: type: number description: HTTP status code origin: type: string description: Error source skulabsTraceId: type: string description: Trace ID for support type: type: string enum: - error - notice - success description: Error severity for UI handling user_error: type: boolean description: Whether the error was caused by user input display: type: string enum: - notification - panel description: Suggested UI display mode for the error required: - message - statusCode required: - error '403': description: Forbidden. Insufficient permissions. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: Detailed error message code: type: string description: Machine-readable error code overview: type: string description: Short human-friendly description statusCode: type: number description: HTTP status code origin: type: string description: Error source skulabsTraceId: type: string description: Trace ID for support type: type: string enum: - error - notice - success description: Error severity for UI handling user_error: type: boolean description: Whether the error was caused by user input display: type: string enum: - notification - panel description: Suggested UI display mode for the error required: - message - statusCode required: - error '429': description: Too many requests. Rate limit exceeded. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: Detailed error message code: type: string description: Machine-readable error code overview: type: string description: Short human-friendly description statusCode: type: number description: HTTP status code origin: type: string description: Error source skulabsTraceId: type: string description: Trace ID for support type: type: string enum: - error - notice - success description: Error severity for UI handling user_error: type: boolean description: Whether the error was caused by user input display: type: string enum: - notification - panel description: Suggested UI display mode for the error required: - message - statusCode required: - error '500': description: Internal server error. content: application/json: schema: type: object properties: error: type: object properties: message: type: string description: Detailed error message code: type: string description: Machine-readable error code overview: type: string description: Short human-friendly description statusCode: type: number description: HTTP status code origin: type: string description: Error source skulabsTraceId: type: string description: Trace ID for support type: type: string enum: - error - notice - success description: Error severity for UI handling user_error: type: boolean description: Whether the error was caused by user input display: type: string enum: - notification - panel description: Suggested UI display mode for the error required: - message - statusCode required: - error security: - SKULabsToken: [] servers: - url: https://api.skulabs.com components: schemas: Shipment: type: object properties: _id: type: string description: Shipment ID example: 507f1f77bcf86cd799439011 user_id: type: string description: User who created the shipment example: 507f1f77bcf86cd799439011 time: type: string description: Shipment creation time example: '2025-01-15T12:00:00.000Z' voided: type: boolean description: Whether the shipment is voided return_label: type: boolean description: Whether this is a return label deducted: type: boolean description: Whether inventory was deducted response: type: object properties: provider: type: string description: Carrier provider name service: type: string description: Service name label_url: type: string description: Label URL tracking_number: type: string description: Tracking number tracking_url: type: string description: Tracking URL amount: type: number description: Shipping cost amount currency: type: string description: Currency code shipment_id: type: string description: External shipment ID signature: type: boolean description: Signature confirmation description: Shipment response details request: type: object properties: order_items: type: array items: $ref: '#/components/schemas/ShipmentOrderItem' description: Items included in shipment parcel: type: object properties: length: type: number description: Package length width: type: number description: Package width height: type: number description: Package height weight: type: number description: Package weight weight_unit: type: string description: Weight unit dimensions_unit: type: string description: Dimensions unit description: Parcel dimensions address: type: object properties: {} description: Ship-to address used in request carrier_account_ids: type: array items: type: string description: Carrier account IDs provider: type: string description: Carrier provider service: nullable: true description: Service code or name description: Shipment request parameters ShipmentOrderItem: type: object properties: item_id: type: string description: Item ID variant_id: type: string description: Variant ID quantity: type: number description: Quantity shipped sku: type: string description: Item SKU securitySchemes: SKULabsToken: type: http scheme: bearer bearerFormat: JWT ````