---
title: "List/Search Routes"
method: GET
path: "/v1/routes"
tags: ["Route"]
---

# List/Search Routes

`GET /v1/routes`

## Request

- Base URL: `https://api.sandbox.usenash.com`
- URL: `https://api.sandbox.usenash.com/v1/routes`
- Auth: none declared

List routes with filters and pagination. Returns a slim payload suitable for discovery; use GET /v1/routes/<id> for full details.

## Query parameters

- `limit` integer
- `offset` integer
- `sortDirection` string: ASC or DESC, applied to created_at
- `startDate` string, date-time, nullable: Defaults to 30 days ago.
- `endDate` string, date-time, nullable: Defaults to now.
- `tags` string, nullable: Comma-separated order tags; matches routes with an order carrying any of them
- `search` string, nullable: Free-form search
- `isDispatched` boolean, nullable: Filter by dispatched state
- `dispatchStrategyId` string, nullable: Comma-separated
- `pickupStoreLocationIds` string, nullable: Comma-separated
- `dropoffStoreLocationIds` string, nullable: Comma-separated
- `city` string, nullable: Comma-separated pickup/dropoff cities
- `state` string, nullable: Comma-separated pickup/dropoff states
- `country` string, nullable: Comma-separated pickup/dropoff countries

## Response `200`

OK

- RouteListPageRead
  - `results` RouteListRead[], required
    - `id` string, required
    - `externalId` string, nullable
    - `name` string, nullable
    - `status` string, nullable
    - `createdAt` string, nullable
    - `updatedAt` string, nullable
    - `portalUrl` string, nullable
    - `providerName` string, nullable
    - `courier` RouteListCourierRead
      - `id` string, nullable
      - `name` string, nullable
    - `vehicle` RouteListVehicleRead
      - `id` string, nullable
      - `name` string, nullable
    - `stopCount` integer, nullable
    - `orderIds` string[], nullable
    - `distanceMeters` integer, nullable
    - `durationSeconds` integer, nullable
  - `totalCount` integer, required
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `422`: Unprocessable Content

---

[API](https://skmtc.dev/nash/apis/nash-api.md) - [All operations](https://skmtc.dev/nash/apis/nash-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nash/apis/nash-api/revisions/e3713837c5c9?raw)