---
title: "Routing Isochrones"
method: POST
path: "/v1/routing-isochrones"
tags: ["research"]
---

# Routing Isochrones

`POST /v1/routing-isochrones`

## Request

- Base URL: `https://agent.pocket.network`
- URL: `https://agent.pocket.network/v1/routing-isochrones`
- Auth: none required

Straight-line geometry, not road routing: a walking-radius circle (speed x time) around a point or geocoded place and, with a destination, the straight-line distance, estimated minutes and whether it is within reach. POST /v1/routing with {from or place, minutes, to}. Places are geocoded with OpenStreetMap Nominatim. Pay per request in USDC; no account, no API key.

## Request body

- object: The request body for POST /v1/routing.
  - `place` string: Place name to geocode (alternative to from).
  - `from` unknown
  - `to` unknown
  - `minutes` number: Travel time in minutes, default 15.
  - `speed_kmh` number: Speed in km/h, default 4.5 (walking).

## Response `200`

The upstream response, served after payment settles.

- object: For POST /v1/routing, a JSON object with origin, minutes, speed_kmh, radius_m, a 24-point polygon, method and, with a destination, to, straight_line_m, within_reach and estimated_minutes. The exact shape is the service's own and is not pinned here; errors return a JSON object with an `error` field.

## Other responses

- `400`: Malformed request.
- `402`: Payment required. The x402 v2 terms are in the PAYMENT-REQUIRED header and, identically, in this body; sign the chosen option and retry with the PAYMENT-SIGNATURE header. The receipt arrives in PAYMENT-RESPONSE.
- `503`: This service is not currently available to serve.

---

[API](https://skmtc.dev/pocket/apis/pocket-agentic-portal.md) · [All operations](https://skmtc.dev/pocket/apis/pocket-agentic-portal/llms.txt) · [OpenAPI document](https://skmtc.dev/pocket/apis/pocket-agentic-portal/revisions/96d2176db014?raw)