# Hailpoint — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Retrieve historical hail maps and detailed storm impact data by location, state, city, or date range. Search for hail events by keyword or geographic filters, view damage severity categories, and access hail report markers with geographic coordinates.

**Category:** Weather | **Website:** [hailpoint.com/](https://hailpoint.com/) | **Docs:** [parse.bot/marketplace/48774159-4b3d-47e1-92f6-7fb44ac756cb/hailpoint-com-api](https://parse.bot/marketplace/48774159-4b3d-47e1-92f6-7fb44ac756cb/hailpoint-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-hailpoint-com-api-48774159/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_hail_damage_categories

Retrieve the hail damage scale/category definitions used to classify storm events on the platform. Returns the four severity tiers: Scattered, Major, Severe, Catastrophic.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hailpoint-com-api-48774159/get_hail_damage_categories \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_hail_map_demo

Access the public demo hail map data. Returns parsed hail report markers with geographic coordinates for the May 21, 2014 Chicago storm event sample.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hailpoint-com-api-48774159/get_hail_map_demo \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_hail_map_details

Get detailed information for a specific hail map event using its detail URL. Returns event metadata, hail reports count, max hail size, and an impact breakdown table by hail size range. The detail_url comes from search_hail_maps results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `detail_url` | string | Yes | Full URL of the hail map detail page (from search_hail_maps results items[*].detail_url). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hailpoint-com-api-48774159/get_hail_map_details \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"detail_url":"<string>"}'
```

### get_hail_maps_by_city

Retrieve historical hail maps for a specific city. Searches by city name with optional state filter. Returns paginated results with up to 15 items per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `city` | string | Yes | City name (e.g. Indianapolis, Houston, Dallas). |
| `page` | integer | No | Page number for pagination. |
| `state` | string | No | Two-letter US state code to narrow results (e.g. IN, TX). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hailpoint-com-api-48774159/get_hail_maps_by_city \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"city":"<string>","page":"<integer>","state":"<string>"}'
```

### get_hail_maps_by_state

Retrieve all hail maps filtered by a specific U.S. state. Returns paginated results with up to 15 items per page.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `state` | string | Yes | Two-letter US state code (e.g. TX, IN, FL). |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hailpoint-com-api-48774159/get_hail_maps_by_state \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>","state":"<string>"}'
```

### get_latest_hail_maps

Retrieve the most recent hail maps across all U.S. states. Returns paginated results with up to 15 items per page sorted by most recent date.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hailpoint-com-api-48774159/get_latest_hail_maps \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"page":"<integer>"}'
```

### get_subscription_plans

Retrieve available subscription plan options and pricing from Hail Point. Returns a static list of plan tiers with monthly pricing.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hailpoint-com-api-48774159/get_subscription_plans \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_hail_maps

Search for hail map events by keyword (city/state/ZIP), state code, category, and date range. Returns paginated results sorted by date with up to 15 items per page. When no filters are provided, returns the most recent events across all states.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `category` | string | No | Damage category filter. |
| `date_from` | string | No | Start date in YYYY-MM-DD format. |
| `date_to` | string | No | End date in YYYY-MM-DD format. |
| `distance` | integer | No | Search radius in miles from keyword location. |
| `keyword` | string | No | City, State, or ZIP code to search near. |
| `page` | integer | No | Page number for pagination. |
| `state` | string | No | Two-letter US state code (e.g. TX, IN) or 'can' for Canada. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hailpoint-com-api-48774159/search_hail_maps \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"category":"<string>","date_from":"<string>","date_to":"<string>","distance":"<integer>","keyword":"<string>","page":"<integer>","state":"<string>"}'
```