---
title: "Email a swath report summary to your account email (summary 1 credit; with limit, billed like the report)"
method: POST
path: "/v1/swaths/{id}/email-report"
---

# Email a swath report summary to your account email (summary 1 credit; with limit, billed like the report)

`POST /v1/swaths/{id}/email-report`

## Request

- Base URL: `https://swathapi.com`
- URL: `https://swathapi.com/v1/swaths/{id}/email-report`
- Auth: HTTP bearer

Sends a branded report summary (max hail/wind, area, county, property count, storm link) to the account email your key was signed up with — no other recipients. Pass limit to include the top N properties, billed like the report endpoint. Keys without an account email get a 400.

## Path parameters

- `id` string, required

## Query parameters

- `limit` integer
- `roof_age_min` number
- `roof_material` string
- `owner_occupied` boolean
- `year_built_before` number
- `year_built_after` number
- `value_min` number
- `value_max` number
- `min_exposure_score` number

## Response `200`

Report emailed to the account address

## Other responses

- `400`: No account email on file, or a filter parameter is not a number
- `401`: Missing, invalid, or revoked API key. Fix: pass Authorization: Bearer sk_... (get a key at /v1/signup).
- `402`: Monthly credit limit reached (code credits_exhausted). Fix: upgrade via POST /v1/billing/checkout or wait for the monthly reset.
- `404`: No such swath
- `429`: Per-minute rate limit for the plan exceeded (code rate_limited). Retry after a short wait.
- `502`: Email send failed — nothing billed
- `503`: Email sending not configured on this server

---

[API](https://skmtc.dev/swathapi/apis/swath-api.md) · [All operations](https://skmtc.dev/swathapi/apis/swath-api/llms.txt) · [OpenAPI document](https://skmtc.dev/swathapi/apis/swath-api/revisions/7dbea40372ef?raw)