---
title: "Get mission progress"
method: GET
path: "/missions/{missionId}/progress"
tags: ["Missions"]
---

# Get mission progress

`GET /missions/{missionId}/progress`

## Request

- Base URL: `https://api.voltairlabs.com`
- URL: `https://api.voltairlabs.com/missions/{missionId}/progress`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/voltairlabs/apis/voltair-api/docs/missions/:missionId/progress/get.ts> (a function with typed inputs; its response is checked against the schema)

Counts every inspected pole of the mission, and every inspected span when the mission is set up to show spans, by inspection status. One entry per unit, poles first. Counts cover the whole mission and are not affected by list filters.

## Response `200`

Success

- object
  - `data` MissionProgress, required
    - `units` object[], required: One entry per unit the mission shows, poles first.
      - `unit` 'poles' | 'spans', required
      - `breakdown` object, required
        - `total` integer, required
        - `found_in_field` integer, required: How many of total were found in the field.
        - `statuses` object[], required: Count per inspection status, in workflow order. A mission without analysis lists only the capture statuses, and counts anything past capture as capture-verified.
          - `status` 'planned' | 'capture-pending' | 'capture-submitted' | 'capture-verified' | 'capture-failed' | 'analysis-pending' | 'analysis-submitted' | 'analysis-verified' | 'analysis-failed' | 'delivered', required
          - `n` integer, required
        - `capture_failed` integer, required
        - `reasons` object[], required: capture-failed count by reason. needs-recapture (Needs refly) is always listed first; tag is null for no reason recorded.
          - `tag` string, nullable, required
          - `n` integer, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions
- `404`: Resource not found
- `429`: Rate limit exceeded
- `500`: Internal server error

## Changes

- **2026-10-27** `ad57aa0e0c40`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/voltairlabs/apis/voltair-api/changes/missions/:missionId/progress/get.md)

---

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