# Hailpoint — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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.beta.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>"}'
```