---
title: "List Dispatch Plans"
method: GET
path: "/v1/plans"
tags: ["Dispatch plans"]
---

# List Dispatch Plans

`GET /v1/plans`

## Request

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

List the active dispatch plans of your organization, newest first. Filter by `search` (name), `source` and `tags`; page with the `nextCursor` of the previous page and the same filters.

## Query parameters

- `limit` integer
- `cursor` string, nullable
- `search` string, nullable
- `source` 'orders' | 'routes' | 'snapshot', nullable
- `tags` string[]

## Response `200`

OK

- DispatchPlanList
  - `plans` DispatchPlanSummary[], required
    - `id` string, required
    - `name` string, required
    - `tags` string[]
    - `source` 'orders' | 'routes' | 'snapshot', required
    - `startDate` string, date, nullable, required
    - `endDate` string, date, nullable, required
    - `timezoneId` string, nullable, required
    - `zoneIds` string[], required
    - `draftRevision` integer, required
    - `draftContentHash` string, required
    - `restoreVersionNumber` integer, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, nullable, required
  - `nextCursor` string, nullable, 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)