> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apps.lute.co.in/llms.txt
> Use this file to discover all available pages before exploring further.

# Assign Courier

> Book shipment with carrier API, generate AWB, and advance status to Ready to ship.

# Assign Courier & Generate AWB

Invokes the appropriate courier adapter (Delhivery, Shadowfax, Xpressbees, or Ekart) to create the shipment in the carrier network, claim an AWB, and commit the status change to `Ready to ship`.

**Courier-First Safety**: This call contacts the carrier API before making changes in Shipdesk. If the carrier rejects the request (e.g. unserved PIN or insufficient balance), your order remains safely in `Awaiting AWB`.

### Path Parameters

**id** `string` *required*

The unique order ID to assign.

### Request Body

**courier** `string` *required*

The courier and service mode combination. Supported values:

* `Delhivery - Surface`
* `Delhivery - Express`
* `Shadowfax`
* `Xpressbees - Surface`
* `Xpressbees - Express`
* `Ekart - Surface`
* `Ekart - Express`

***

### Response Example

```json theme={null}
{
  "success": true,
  "data": {
    "awb": "129038102931",
    "carrier": "Delhivery",
    "mode": "Express",
    "pickupId": null,
    "status": "Ready to ship",
    "edd": "2026-11-25",
    "labelUrl": null
  },
  "meta": {
    "timestamp": "2026-11-22T16:30:30.000Z",
    "request_id": "req_88192031"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.