---
title: "Get an isoline as H3 cells"
method: GET
path: "/v3/lds/isolines/h3"
tags: ["LDS"]
---

# Get an isoline as H3 cells

`GET /v3/lds/isolines/h3`

Returns the area reachable from a point as a list of H3 cells, each with
the travel time to reach it.

Use this instead of `/v3/lds/isolines` when you want to join the result to
other H3 data, or render it as a spatial index layer rather than a polygon.

Only available when your organization's provider is **TravelTime**. Each
request consumes 5 units of your LDS quota.

## Query parameters

- `origin` string, required
- `mode` 'cycling' | 'driving' | 'driving+train' | 'driving+public_transport' | 'public_transport' | 'walking' | 'coach' | 'bus' | 'train' | 'ferry' | 'driving+ferry' | 'cycling+ferry' | 'cycling+public_transport', required
- `travelTime` integer, required
- `resolution` integer, required
- `options` string

## Response `200`

The H3 cells covering the reachable area.

- object[]
  - `id` string — The H3 cell index.
  - `min` number — Shortest travel time to the cell, in seconds.
  - `max` number — Longest travel time to the cell, in seconds.
  - `mean` number — Mean travel time to the cell, in seconds.

## Other responses

- `400` — The request is malformed or a parameter failed validation.
- `401` — The token is missing, malformed or expired.
- `403` — The token doesn't grant access to this resource.
- `429` — You went over the [rate limit](#rate-limits) for this API.

---

[API](https://skmtc.net/gitbookio/apis/carto-api.md) · [All operations](https://skmtc.net/gitbookio/apis/carto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gitbookio/carto-api/revisions/019f79ecdd6c/schema)