---
title: "Subsurface Velocity Profile"
method: POST
path: "/api/v1/subsurface/velocity-profile"
tags: ["Subsurface Imaging"]
---

# Subsurface Velocity Profile

`POST /api/v1/subsurface/velocity-profile`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/subsurface/velocity-profile`
- Auth: none declared

Invert a dispersion curve for a 1D shear-wave velocity profile.

Uses iterative linearized inversion to recover a depth-dependent
Vs profile from the measured dispersion curve.  Returns layer
thicknesses, velocities, and misfit statistics.

Parameters (JSON body):
- dispersion_curve : dict -- Dispersion data with periods and velocities (required)
- max_depth_km : float -- Maximum inversion depth in km (optional, default 50)
- n_layers : int -- Number of layers in model (optional)

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