Help Centre / API / Runs endpoints

Runs endpoints

Updated just now · 8 views ·

List runs on a map

GET /api/v1/maps/{id}/runs

Returns numbered runs with per-run summary metrics (total time, PCE).

Get a single run

GET /api/v1/runs/{run_id}

Includes every step of the run with its individual timing, notes, and photo references.

Compare runs

POST /api/v1/runs/compare

{
  "run_ids": [42, 51, 63]
}

Returns per-stage min/max/avg/median across the selected runs.

Delete a run

POST /api/v1/runs/{run_id}/delete

Was this article helpful?

0 found this helpful

Related Articles

Getting an API key

How to create, view, and revoke API keys for programmatic access to MapVS.

Authenticating requests

Include your API key as a Bearer token on every request. Here's the exact format.

Rate limits

Per-key limits, headers to inspect, and how to back off gracefully.

Errors and status codes

The complete list of status codes and error envelope format returned by the MapVS API.