---
title: "Aquifer Dvv Correlate"
method: POST
path: "/api/v1/aquifer-dvv/correlate"
tags: ["Aquifer-Seismic dv/v Monitoring"]
---

# Aquifer Dvv Correlate

`POST /api/v1/aquifer-dvv/correlate`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/aquifer-dvv/correlate`
- Auth: none declared

Cross-correlate groundwater level with seismic dv/v time series.

Aligns water level and dv/v time series, computes zero-lag and
lagged cross-correlation, seasonal decomposition, storativity
estimation, and drought stress indicator.

Parameters (JSON body):
- water_levels_ft : list[float] -- Water depth below surface (feet, required)
- water_dates : list[str] -- ISO dates for water level measurements (required)
- dvv_pct : list[float] -- dv/v time series (percent change, required)
- dvv_dates : list[str] -- ISO dates for dv/v measurements (required)
- max_lag_days : int -- Maximum lag for cross-correlation (days, default 90)

Returns correlation coefficient, optimal lag, seasonal analysis,
storativity estimate, and drought indicator.

**Pricing:** Included in subscription tiers (legacy list price: GET /api/v1/billing/pricing).

## Query parameters

- `x_api_key` string, nullable

## Request body

- object

## 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)