---
title: "Search for regions within travel time"
method: POST
path: "/{country}/{version}/{level}/traveltime"
tags: ["Regions"]
---

# Search for regions within travel time

`POST /{country}/{version}/{level}/traveltime`

> Travel time analyses provided by [Targomo](https://www.targomo.com/developers/resources/attribution).

Search for all regions with a specified travel time of a point. By default, the maximum travel time is 120 minutes.

This endpoint requires additonal permissions, please [contact us](https://docs.lightcast.dev/contact) if you'd like access to traveltime.

## Path parameters

- `country` string, required
- `version` string, required
- `level` string, required

## Request body

- object
  - `lat` number, required
  - `lon` number, required
  - `traveltimes` unknown[], required — Up to 6 travel times (drive times) can be run at a time. By default, the maximum travel time is 120 minutes, but more can be requested.
    - unknown
  - `intersectionMethod` 'contained' | 'centroid' | 'touching' — * `touching` - Any region that is touching (intersects) the requested area. * `centroid` - Any region's who's centroid lies inside of the requested area. * `contained` - Any region that lies entirely inside of the requested area.

## Response `200`

OK

- object — Travel time response structure.
  - `traveltimes` object[], required
    - `traveltime` integer, required — Travel time in minutes.
    - `geojson` object, nullable
      - `type` 'Feature', required — The type of the geojson object. Always a feature.
      - `geometry` object, required
        - `type` 'Point' | 'MultiPoint' | 'LineString' | 'MultiLineString' | 'Polygon' | 'MultiPolygon', required
        - `coordinates` unknown[], required
          - unknown
      - `properties` object, required
    - `codes` string[], nullable, required

## Other responses

- `400` — bad request
- `403` — You don't have access to traveltime data.
- `404` — requested resource not found

---

[API](https://skmtc.net/lightcast/apis/alumni-pathways-2-0.md) · [All operations](https://skmtc.net/lightcast/apis/alumni-pathways-2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lightcast/alumni-pathways-2-0/revisions/fc66b9877391/schema)