---
title: "Nearest traffic station + AADT history"
method: GET
path: "/api/v1/parcels/{id}/traffic-history"
tags: ["Parcels"]
---

# Nearest traffic station + AADT history

`GET /api/v1/parcels/{id}/traffic-history`

## Request

- Base URL: `https://propraven.com`
- URL: `https://propraven.com/api/v1/parcels/{id}/traffic-history`
- Auth: HTTP bearer

Finds the AADT (annual average daily traffic) station nearest to the given coordinates and returns its historical time series plus 3/5/7-year CAGRs. Useful for retail / CRE site selection. Search radius ~2 miles; returns empty data if no station is in range.

## Path parameters

- `id` string, required

## Query parameters

- `lat` number, double, required
- `lng` number, double, required

## Response `200`

Nearest station data + historical AADT.

- TrafficStationHistory
  - `direct_vpd` number, nullable, required
  - `nearby_vpd` number, nullable, required
  - `vpd_visibility_score` number, nullable, required
  - `withhold_gate` object, required
    - `applied` boolean, nullable, required
    - `suppressed` string[], required
    - `reason` string, nullable, required
    - `reasons` object, required
      - `direct_vpd` string, nullable, required
      - `nearby_vpd` string, nullable, required
      - `vpd_visibility_score` string, nullable, required
    - `withheld_on` string, nullable, required
    - `note` string, nullable, required
  - `points` object[], required
    - `date` string, nullable, required
    - `vpd` number, nullable, required
  - `station` object, required
    - `id` string, required
    - `station_id` string, nullable, required
    - `route_name` string, nullable, required
    - `functional_class` string, nullable, required
    - `aadt_current` number, nullable, required: Most recent AADT count.
    - `aadt_year` integer, nullable, required
    - `cagr_3yr` number, nullable, required
    - `cagr_5yr` number, nullable, required
    - `cagr_7yr` number, nullable, required
    - `latitude` number, nullable, required
    - `longitude` number, nullable, required
  - `time_series` object[], required
    - `year` integer, nullable, required
    - `aadt` number, nullable, required
  - `history` object[]: Year-keyed historical counts (newest last).
    - `year` integer
    - `aadt` integer, nullable

## Other responses

- `400`: lat / lng required.
- `401`: Missing, malformed or invalid credential.
- `404`: The resource (or the endpoint) does not exist.
- `405`: The endpoint exists but does not support this method. `Allow` lists the methods it does.
- `429`: Rate limit exceeded.
- `500`: Unexpected server error. The body never carries database or driver text.

---

[API](https://skmtc.dev/propraven/apis/propraven-api.md) · [All operations](https://skmtc.dev/propraven/apis/propraven-api/llms.txt) · [OpenAPI document](https://skmtc.dev/propraven/apis/propraven-api/revisions/37f8158c4eda?raw)