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

# List Routes

> Returns routes for your account, newest first.

**status** `string`

Filter by route status: `Draft`, `Optimized`, `Error`, `Dispatched`, `Active`, or `Completed`.

**scheduleDate** `string`

Filter to routes scheduled on this date (`YYYY-MM-DD`).

**limit** `integer` (default: 25)

Number of routes to return (max 100).

**before** `string`

Cursor — return routes created before this ISO 8601 timestamp.

```bash cURL theme={null}
curl -H "X-API-Key: bk_live_..." \
     "https://api.bodha.run/api/v1/routes?status=Dispatched&limit=10"
```

```json 200 theme={null}
{
  "data": [
    {
      "id": "665f1a2b3c4d5e6f7a8b9c0d",
      "name": "Monday North",
      "scheduleDate": "2026-10-28T00:00:00.000Z",
      "status": "Dispatched",
      "drivers": [
        {
          "driverId": "664a1b2c3d4e5f6a7b8c9d0e",
          "color": "#3B82F6",
          "depot": {
            "name": "Main Warehouse",
            "startLocation": {
              "address": "123 Main St",
              "latitude": 37.7749,
              "longitude": -122.4194
            },
            "startTime": "08:00",
            "returnToStart": true
          }
        }
      ],
      "stopCount": 24,
      "createdAt": "2026-10-27T14:30:00.000Z",
      "updatedAt": "2026-10-28T08:15:00.000Z"
    }
  ],
  "hasMore": true
}
```


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