---
title: "Portfolio Pml"
method: POST
path: "/api/v1/insurance/portfolio/pml"
tags: ["Underwriter Portfolio"]
---

# Portfolio Pml

`POST /api/v1/insurance/portfolio/pml`

## Request

- Base URL: `https://www.deepmapai.com`
- URL: `https://www.deepmapai.com/api/v1/insurance/portfolio/pml`
- Auth: none declared

Portfolio PML (Probable Maximum Loss) exceedance curve.

Computes PML at specified return periods using a simplified
beta-distribution exceedance model with geographic correlation
adjustments for clustered properties.

**Request body:**
```json
{
    "properties": [
        {"lat": 34.05, "lon": -118.25, "replacement_value_usd": 800000},
        ...
    ],
    "return_periods": [50, 100, 250, 500],
    "perils": ["earthquake", "wildfire"]
}
```

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

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