# POST /v1/reach > Index: https://kartpunkt.se/llms.txt operationId: `measureReach`. What can be reached within a budget. Tag: `routing`. The area reachable from a point within each budget, seconds of travel or metres along the network, as one polygon per budget. Use it to show what lies within reach; to measure to places you know, use POST /v1/distances. It costs a calculation per budget value. ## Request `POST https://api.kartpunkt.se/v1/reach` with `Authorization: Bearer $KARTPUNKT_API_KEY` and `Content-Type: application/json`, from your backend (never browser code: the key would leak, and CORS is not enabled). Example body: ```json { "origin": { "lat": 63.72059, "lon": 19.342166 }, "profile": "walk", "budget": { "duration_s": [ 120, 300 ] } } ``` JSON body: - `origin` ([StreetPoint](https://api.kartpunkt.se/docs/shapes/StreetPoint.md), required) - `profile` ([Profile](https://api.kartpunkt.se/docs/shapes/Profile.md), required) - `budget` (object, required): How far to reach: duration_s or distance_m, one list or the other. - Either `{ duration_s }`: - `duration_s` (array of number <= 7200, 1..4 items, required): Seconds of travel, one area per value: free flow by car or hgv, the profile's own pace on foot or by bike. Refused on car_shortest, which takes metres. - Or `{ distance_m }`: - `distance_m` (array of number <= 100000, 1..4 items, required): Metres along the network, one area per value, on any profile. - `network` ([NetworkSelector](https://api.kartpunkt.se/docs/shapes/NetworkSelector.md), optional) ## Response 200 Example: ```json { "areas": [ { "duration_s": 120, "distance_m": null, "geometry": { "type": "Polygon", "coordinates": [ [ [ 19.338783582223183, 63.71902855423934 ], [ 19.347314732223182, 63.715174854239336 ], [ 19.348141132223184, 63.72054395423933 ], [ 19.345388732223185, 63.722425204239336 ], [ 19.342360632223183, 63.72251670423934 ], [ 19.34225985, 63.722519750000004 ], [ 19.33923175, 63.72261105 ], [ 19.33895725, 63.7208213 ], [ 19.33882685, 63.7199712 ], [ 19.33881315, 63.7198817 ], [ 19.3386828, 63.7190316 ], [ 19.338783582223183, 63.71902855423934 ] ] ] } }, { "duration_s": 300, "distance_m": null, "geometry": { "type": "Polygon", "coordinates": [ [ [ 19.3331758, 63.72279355 ], [ 19.3329017, 63.7210038 ], [ 19.3357991, 63.7200625 ], [ 19.33882685, 63.7199712 ], [ 19.33881315, 63.7198817 ], [ 19.3386828, 63.7190316 ], [ 19.338783582223183, 63.71902855423934 ], [ 19.347314732223182, 63.715174854239336 ], [ 19.348141132223184, 63.72054395423933 ], [ 19.345388732223185, 63.722425204239336 ], [ 19.345562800000003, 63.72421799999999 ], [ 19.342940300000002, 63.7269493 ], [ 19.34143285, 63.72703975 ], [ 19.3395066, 63.7244008 ], [ 19.33923175, 63.72261105 ], [ 19.336204, 63.72270235 ], [ 19.3331758, 63.72279355 ] ] ] } } ], "provenance": { "synthetic": true, "network": { "id": "snap_01k7exampleexampleexample0", "dataset": "nvdb", "source_date": "2026-10-13", "built_at": "2026-10-13T07:00:00.000Z", "graph": "snap_01k7exampleexampleexample0", "profile": "walk", "experimental": false }, "sources": [ { "id": "nvdb", "name": "Trafikverket, NVDB", "licence": "CC0-1.0", "attribution": "Vägdata från NVDB, Trafikverket, CC0 1.0", "url": "https://creativecommons.org/publicdomain/zero/1.0/", "updated": "2026-10-13" } ] } } ``` - `areas` (array of object) - `duration_s` (number | null): This area's budget in seconds when the budget was duration_s; else null. - `distance_m` (number | null): This area's budget in metres when the budget was distance_m; else null. - `geometry` (object) - `type` ("Polygon") - `coordinates` (array of array of array of number) - `provenance` ([Provenance](https://api.kartpunkt.se/docs/shapes/Provenance.md)) ## Errors Every error is `{ error, message, param?, doc_url }`; `message` says what to do next. All codes: [https://api.kartpunkt.se/errors](https://api.kartpunkt.se/errors). What to do on each, with retries: [https://api.kartpunkt.se/docs/recipes/errors-and-retries.md](https://api.kartpunkt.se/docs/recipes/errors-and-retries.md). - [`invalid_request`](https://api.kartpunkt.se/errors/invalid_request) (400): The request does not match the API schema. Fix the fields named in this message; see /openapi.json. - [`unauthorized`](https://api.kartpunkt.se/errors/unauthorized) (401): Missing or unknown API key. Send it as 'Authorization: Bearer ' (or 'x-api-key'), read from the KARTPUNKT_API_KEY environment variable. The user creates a kp_test_ key on their Kartpunkt account page (https://kartpunkt.se/konto) and puts it in KARTPUNKT_API_KEY themselves; never ask them to paste a key into chat. - [`live_access_required`](https://api.kartpunkt.se/errors/live_access_required) (403): This account is not approved for live data: kp_live_ keys are for customers under contract. Use a kp_test_ key. To ask for live access, the account holder writes to hej@kartpunkt.se, or orders a plan at https://kartpunkt.se/konto#plan. - [`use_not_permitted`](https://api.kartpunkt.se/errors/use_not_permitted) (403): This operation would use a data source in a way its licence or approval does not allow (see GET /v1/sources). It cannot be answered for this key. - [`network_unavailable`](https://api.kartpunkt.se/errors/network_unavailable) (404): No network snapshot matches that id or as_of. List the snapshots with GET /v1/networks and send one of their ids, or leave network out for the active one. - [`network_not_active`](https://api.kartpunkt.se/errors/network_not_active) (409): That network snapshot is not the one served now, and answers on another snapshot are computed as jobs. Send the same input to POST /v1/jobs with this operation, then read GET /v1/jobs/{id}. - [`profile_unavailable`](https://api.kartpunkt.se/errors/profile_unavailable) (409): This profile cannot be answered on the network snapshot asked for: it was built without the data the profile needs (see GET /v1/profiles and the snapshot's manifest at GET /v1/networks/{id}). Use another profile or a newer snapshot. - [`network_pruned`](https://api.kartpunkt.se/errors/network_pruned) (410): That network snapshot was pruned: its tables and graph are deleted, so nothing can be answered on it again, as a job or otherwise. Leave network out to answer on the active network, and store that answer's provenance.network.id; GET /v1/networks lists the snapshots that are not pruned. - [`too_large`](https://api.kartpunkt.se/errors/too_large) (413): Too much for one synchronous call. Send the same input to POST /v1/jobs with this operation and read the result from GET /v1/jobs/{id}, or split it. - [`quota_exceeded`](https://api.kartpunkt.se/errors/quota_exceeded) (429): Request limit or plan quota reached (per minute, per day, or the account plan's monthly quota). Wait the number of seconds in the Retry-After header, then retry; without Retry-After, no wait helps: tell the account holder what this message says. - [`internal_error`](https://api.kartpunkt.se/errors/internal_error) (500): Something failed on our side. Retry after a few seconds; if it keeps failing, contact hej@kartpunkt.se. - [`live_data_unavailable`](https://api.kartpunkt.se/errors/live_data_unavailable) (503): Live data is not available yet: it opens when Kartpunkt's import of Lantmäteriet's address register completes. Use a kp_test_ key until then. - [`routing_unavailable`](https://api.kartpunkt.se/errors/routing_unavailable) (503): Road distances and routes are not available yet: Kartpunkt's road graph from Trafikverket's NVDB has not been built. Try again later. ## Limits | Limit | Synchronous | As a job (`POST /v1/jobs`, `operation: "reach"`) | | --- | --- | --- | | Budget values (`budget.duration_s` or `budget.distance_m`) | 4 | 4 | | `budget.duration_s[]` (each at most) | 7200 | 7200 | | `budget.distance_m[]` (each at most) | 100000 | 100000 | | Request body | 1 MB | 8 MB | Above a synchronous limit the call is refused (413 `too_large`, or 400 `invalid_request` naming the field); send the same input as a job. ## Metering Calculations: 1 per budget value (one per area drawn).