> ## 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.

# Schedule Pickups

> Request courier pickups for ready-to-ship orders grouped by warehouse and carrier.

# Schedule Pickups

Requests warehouse collections for orders with issued AWBs. Shipdesk automatically groups the orders by carrier and warehouse location, booking one pickup per group with the carrier.

### Request Body

**orders** `array` *required*

Array of Order IDs (e.g. `["ORD-2026-9041", "ORD-2026-9042"]`).

**date** `string` *required*

Requested pickup date in `YYYY-MM-DD` format.

**slot** `string` *required*

Pickup time window (e.g. `10:00 - 13:00` or `14:00 - 18:00`).

***

### Response Example

```json theme={null}
{
  "success": true,
  "data": {
    "pickups": [
      {
        "id": "PKP-2026-801",
        "carrier": "Delhivery",
        "warehouse": "Primary Blr Warehouse",
        "date": "2026-11-23",
        "slot": "10:00 - 13:00",
        "packages": 2,
        "reference": "DEL_PU_9849201",
        "status": "Scheduled"
      }
    ],
    "failed": []
  },
  "meta": {
    "timestamp": "2026-11-22T16:33:00.000Z",
    "request_id": "req_44920192"
  }
}
```


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