Overview
Developer Tools
Migration Guides
Travel Time Matrix API
Isochrone API
H3 API
Geohash API
Distance Map API
Routes API
Geocoding API
Additional API Reference
Error Handling
ArcGIS plugin
Alteryx plugin
/v4/time-filter/postcode-sectors

Travel Time Matrix (Postcode Sectors)
Copy link

Find postcode sectors that have a certain coverage from origin (or to destination) and get statistics about such postcode sectors. Currently only supports United Kingdom.

Request Body
Copy link

array[object]

Searches based on departure time. Leave departure location at no earlier than given time. You can define a maximum of 10 searches.

Hide child attributes

You will have to reference this id in your searches. It will also be used in the response body. Must be unique among all locations.

The coordinates of the locations.

Show child attributes
date in extended ISO-8601 format

Leave departure location at no earlier than given time. In ISO 8601 format. For example:
2026-03-06T11:00:00Z (representing UTC)
2026-03-06T11:00:00-05:00 (representing New York on Standard Time: UTC-05:00)

Maximum journey time (in seconds).
Maximum value is 14400 (4 hours) as standard. To discuss increasing this, please contact hello@traveltime.com.

Transportation mode and related parameters. The default parameters are sensible and it is usually enough to only specify the type.

Show child attributes

A number between 0.0 and 1.0. For example, if 0.5 is used, only sectors that have at least 50% postcodes that can be reached within the given travel_time will be included in the response. 0 will return sectors that have at least a single reachable postcode

Properties returned about the sectors.

  • travel_time_reachable - travel time statistics calculated from reachable postcodes in the sector
  • travel_time_all - travel time statistics calculated from all postcodes in the sector
  • coverage - percentage of reachable postcodes in the sector

object | optional

When enabled, range adds a departure window to the departure time, and results are returned for any journeys that depart during this window.
In the results array, the properties of these multiple alternative results are sorted by travel_time in ascending order.
Disabled by default.
Used in public_transport, coach, bus, train, driving+train, driving+public_transport and cycling+public_transport transportation modes. For other modes range search parameters are ignored.

Show child attributes
object | optional

Adjusts the process of looking up the nearest roads from the departure / arrival points.

Show child attributes
array[object]

Searches based on arrival time. Arrive at destination location at no later than given time. You can define a maximum of 10 searches.

Show child attributes

Response Body
Copy link

array[object]

The results array which is sorted lexicographically by the id attribute.

Hide child attributes
array[object]
Show child attributes
Hide code example

Request

Loading

Response

Loading