---
title: "Dvv Regional"
method: GET
path: "/api/v1/cross/interferometry/dvv-regional"
tags: ["Ambient Noise Interferometry"]
---

# Dvv Regional

`GET /api/v1/cross/interferometry/dvv-regional`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/cross/interferometry/dvv-regional`
- Auth: none declared

Get the regional dv/v summary for the station pairs near a point.

**Pricing:** Included in subscription tiers (legacy list price: GET /api/v1/billing/pricing). Requires authentication.
Served ONLY from the fixed method (in production since 2026-10-14), and only when at
least 10 station pairs have a servable row: `median_dvv_pct` is the median over pairs of each
pair's mean (the validated network-level form), `avg_dvv_pct` the plain mean of the rows.
Rows computed by the earlier pipeline are never served (null, with the reason and the
count withheld). No trend label is given. The claim is in `dvv_validation`.

## Query parameters

- `lat` number, required: Center latitude
- `lon` number, required: Center longitude
- `radius_km` number: Region radius in km
- `window_days` integer: Reference window (90, 180, or 365); only 90 has a validated fixed-method series
- `days` integer: Days of recent data to summarize
- `band` string: Frequency band: 'deep' (0.1-0.5 Hz) or 'mid' (0.5-2 Hz); other bands are not validated
- `x_api_key` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/deepmapai/apis/deepmap-ai.md) · [All operations](https://skmtc.dev/deepmapai/apis/deepmap-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/deepmapai/apis/deepmap-ai/revisions/dab995d977d0?raw)