---
title: "Live traffic - speed and congestion for a point"
method: GET
path: "/v1/traffic"
tags: ["Conditions"]
---

# Live traffic - speed and congestion for a point

`GET /v1/traffic`

## Request

- Base URL: `https://geo.thinair.co`
- URL: `https://geo.thinair.co/v1/traffic`
- Auth: HTTP bearer

Live traffic conditions and speed aggregates at a coordinate. Coverage is concentrated in major US metros; outside coverage areas the response carries `coverage: false`.

## Query parameters

- `lat` number, required: Latitude in decimal degrees, WGS84.
- `lon` number, required: Longitude in decimal degrees, WGS84.
- `units` 'miles' | 'kilometers': Speed units. Auto-detected from location (mph in US/UK/Myanmar/Liberia, km/h elsewhere) when omitted. Accepts 'km'/'mi' as aliases for 'kilometers'/'miles'.

## Response `200`

Traffic conditions for the queried point.

- TrafficResponse: Pass-through of the typed TrafficResult. `coverage: false` means no live data was returned; `coverage_reason` names the cause when it is known to be something other than the location (`disabled`, `unavailable`) and is absent for a genuine coverage gap.
  - `lat` number, required
  - `lon` number, required
  - `coverage` boolean
  - `coverage_reason` 'disabled' | 'unavailable'
  - `current_speed` number, nullable, required
  - `free_flow_speed` number, nullable, required
  - `ratio_pct` number, nullable, required
  - `units` string, required
  - `segments` object[], required
  - `segment_count` number, required
  - `closures` number, required
  - `congestion` string, required
  - `meta` object, required
    - `upstream_ms` number, required
    - `feature_count` number, required
    - `cacheHit` boolean
  - `upstream_error` string, nullable

## Other responses

- `400`: Validation error.
- `429`: Quota exceeded.
- `503`: Live traffic capacity temporarily exhausted (code BACKPRESSURE). Retryable: `retry_after_ms` and the `Retry-After` header point at the next 00:00 UTC reset. Not charged.

---

[API](https://skmtc.dev/thinair/apis/thinair-geo-api.md) · [All operations](https://skmtc.dev/thinair/apis/thinair-geo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thinair/apis/thinair-geo-api/revisions/8fac2d5e4b34?raw)