---
title: "Assess Geomagnetic Coupling"
method: POST
path: "/api/v1/space-weather/coupling/assess"
tags: ["Geomagnetic Coupling"]
---

# Assess Geomagnetic Coupling

`POST /api/v1/space-weather/coupling/assess`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/space-weather/coupling/assess`
- Auth: none declared

Full geomagnetic coupling assessment for a geographic location.

Computes 22 coupling features spanning GIC estimation, volcanic
outgassing enhancement, seismicity modulation, and ionospheric
TEC anomalies from live NOAA SWPC data.

Required fields: ``lat``, ``lon``
Optional fields: ``volcano_type``, ``tectonic_setting``,
    ``soil_resistivity``, ``use_demo``

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

Returns composite 0-100 coupling score with 4 component scores,
22-feature vector, storm classification, and recommendations.

## Query parameters

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