---
title: "Confirm a free business alert or a coverage request"
method: POST
path: "/subscribe"
---

# Confirm a free business alert or a coverage request

`POST /subscribe`

## Request

- Base URL: `https://api.lodestarstamp.com`
- URL: `https://api.lodestarstamp.com/subscribe`
- Auth: one of:
  - none
  - API key in header `X-Lodestar-Key`
  - OAuth 2 (authorization code, authorization URL `https://api.lodestarstamp.com/oauth/authorize`, token URL `https://api.lodestarstamp.com/oauth/token`, scopes: `mcp:read`)
  - API key in header `PAYMENT-SIGNATURE`

## Request body

- object
  - `email` string, email, required
  - `business_name` string: Required unless wanted_market is supplied. Exact name; ambiguous matches are coverage requests, never silently selected.
  - `market` string: Covered market slug; omitted legacy requests use chicago-hvac.
  - `intent` 'shop_moved' | 'coverage_request': A coverage_request records demand only; automatic first-appearance delivery is not implemented.
  - `wanted_market` string: Optional. Trade + city for a market not yet covered; routes to the honest double opt-in waitlist instead of the move list.
  - `website` string: Honeypot; must be empty

## Response `200`

Confirmation email sent

## Other responses

- `400`: Invalid request
- `429`: Rate limited

---

[API](https://skmtc.dev/lodestarstamp/apis/lodestar-trust-api.md) · [All operations](https://skmtc.dev/lodestarstamp/apis/lodestar-trust-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lodestarstamp/apis/lodestar-trust-api/revisions/af78368ab7a5?raw)
