# Get Shipment Info

The Get Shipment Info API provides a lightweight method to retrieve essential order information without fetching the complete order payload. This endpoint is optimized for quick status checks, delivering crucial details such as order status, order type, SLA deadlines, lock status, and processing due times. It is ideal for monitoring order queues, checking fulfillment readiness, and implementing efficient polling mechanisms.

Use this API when you need fast access to order metadata without the overhead of parsing full order details, making it perfect for dashboard views, status monitoring systems, and pre-processing validation checks.

> **Request Type:** `GET`
**Scheme:** `HTTPS`
**Endpoint:** `https://{{host}}/oms/v3/shipment/info`


Try out Fynd Konnect's Get Shipment Info Endpoint
br
**Common Request Headers**

| Header | Mandatory | Description |
|  --- | --- | --- |
| `x-access-token` | Yes | Access token used for authenticating API requests to Fynd Konnect |
| `Content-Type` | Yes | `application/json` |


Best Practices
1. **Use for status polling**: Ideal for frequent status checks without full payload overhead
2. **Check lock status first**: Verify `lockStatus` before attempting order modifications to avoid conflicts
3. **Monitor SLA deadlines**: Use `sla` field to prioritize order processing and prevent TAT breaches
4. **Filter by orderStatus**: Retrieve shipments in specific states for targeted processing workflows
5. **Validate before operations**: Check shipment info before calling pack, invoice, or dispatch APIs


### Query Parameters

Parameter Requirements
Either `orderId` OR `orderStatus` is mandatory. You must provide at least one parameter:

* Use `orderId` to get info for a specific shipment
* Use `orderStatus` to retrieve all shipments in a particular state


### Success Response

### API Call Example

### Example Response

Query by orderStatus
Retrieve lightweight info for all shipments in a specific status:


```json
  {
    "orders": [
      {
        "id": "17614789115571370742",
        "marketplaceOrderId": "FY68FE08FF517FA67468",
        "orderStatus": "CREATED",
        "order_type": "HomeDelivery",
        "is_self_ship": false,
        "orderDate": "2025-10-26T17:11:52+00:00",
        "sla": "2025-10-28T17:15:11.946627+05:30",
        "paymentType": "COD",
        "lockStatus": false,
        "lock_data": {
          "locked": false,
          "mto": false,
          "lock_message": ""
        },
        "processingDueTime": null,
        "orderItems": null
      }
    ]
  }
```

Query by orderId
Retrieve detailed info for a specific shipment including order items:


```json
  {
    "orders": [
      {
        "id": "17614789115571370742",
        "marketplaceOrderId": "FY68FE08FF517FA67468",
        "orderStatus": "CREATED",
        "order_type": "HomeDelivery",
        "is_self_ship": false,
        "orderDate": "2025-10-26T17:11:52+00:00",
        "sla": "2025-10-28T17:20:20.796787+05:30",
        "paymentType": "COD",
        "lockStatus": false,
        "lock_data": {
          "locked": false,
          "mto": false,
          "lock_message": ""
        },
        "processingDueTime": null,
        "orderItems": [
          {
            "orderItemId": "3628064",
            "sku": "NIKE-FJ-0001",
            "status": "CREATED",
            "serialNumberRequired": false,
            "hazmatLabelRequired": null
          }
        ]
      }
    ]
  }
```