---
title: "List dispatch requests"
method: GET
path: "/v1/dispatch_requests"
tags: ["Dispatch requests"]
---

# List dispatch requests

`GET /v1/dispatch_requests`

## Request

- Base URL: `https://api.navigateai.co`
- URL: `https://api.navigateai.co/v1/dispatch_requests`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/navigateai/apis/navigateai-api/docs/v1/dispatch_requests/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `status` 'unstarted' | 'started' | 'submitted' | 'completed' | 'cancelled', nullable: Filter requests by lifecycle status.
- `assigned` boolean, nullable: Filter by whether a request currently has an assignee.
- `reference_key` string, nullable: Filter requests by customer-provided identifier.
- `limit` integer: Maximum number of requests to return.
- `cursor` string, nullable: Opaque cursor returned by a previous list request.

## Response `200`

OK

- ListDispatchRequestsResponse
  - `dispatch_requests` DispatchRequestExternalSchema[], required
    - `id` string, required: NavigateAI identifier for this dispatch request.
    - `location_id` string, required: NavigateAI identifier for the location where work should be performed.
    - `visit_type_slug` string, required: Slug identifying the visit type to use for this request.
    - `work_order_id` string, nullable, required: NavigateAI identifier for the related work order, if one was provided.
    - `prefill_scope_id` string, nullable, required: NavigateAI identifier for the scope to prefill the visit with, if one was provided.
    - `target_scope_id` string, nullable, required: NavigateAI identifier for the scope whose work the visit checks or updates, if one was provided.
    - `assignee_email` string, nullable, required: Email address of the user assigned to this request, if any.
    - `reference_key` string, nullable, required: Optional customer-provided identifier for this request, unique within your organization.
    - `status` 'unstarted' | 'started' | 'submitted' | 'completed' | 'cancelled', required: Current lifecycle status of this dispatch request, independent of assignment.
    - `created_at` string, date-time, required: When this dispatch request was created.
    - `assigned_at` string, date-time, nullable, required: When the current assignee was assigned, if applicable. Assignment is independent of lifecycle status.
    - `started_at` string, date-time, nullable, required: When work on this request began, such as a capture session starting or a visit being created for it. Null if work has not started.
    - `submitted_at` string, date-time, nullable, required: When the field work for this request was submitted, meaning capture finished or an upload of already-captured data began. Uploads may still be finishing. Capture flows that do not report submission separately set this when the request completes.
    - `completed_at` string, date-time, nullable, required: When work on this request was completed, which is when its uploads finished, if applicable.
    - `cancelled_at` string, date-time, nullable, required: When this request was cancelled, if applicable.
    - `metadata` object, required: Customer-provided metadata associated with this request.
    - `deeplink_url` string, required: Mobile deeplink that opens the NavigateAI app directly to the capture flow for this request. Share it with the assignee to have their capture tracked against this request; see the deeplinks guide.
  - `next_cursor` string, nullable, required

## Changes

- **2026-10-15** `b928dbabd4e8`: 1 info
  - added the required property `dispatch_requests/items/target_scope_id` to the response with the `200` status
- **2026-10-14** `bbdde99b5256`: 1 breaking, 1 info
  - removed the required property `dispatch_requests/items/assignee_user_id` from the response with the `200` status
  - added the required property `dispatch_requests/items/assignee_email` to the response with the `200` status
- **2026-10-06** `abd5663eb6b6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/navigateai/apis/navigateai-api/changes/v1/dispatch_requests/get.md)

---

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