# Botmail Claim API

**Canonical:** https://apis.io/apis/botmail-pro/botmail-pro-claim-api/  
**Provider:** Botmail — https://apis.io/providers/botmail-pro/  
**Base URL:** https://botmail.pro  
**Documentation:** https://botmail.pro/v1/openapi.yaml

Botmail Claim API is one of 10 APIs that [Botmail](https://apis.io/providers/botmail-pro/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Claim. The published artifact set on APIs.io includes an OpenAPI specification.

Agent claim flow. 1) `GET /v1/claim/challenge` and solve the proof of work. 2) `POST /v1/claim` → address + pending key + `claim_url`. 3) Give the human `claim_url` (or `POST /v1/claim/notify`). 4) Poll `GET /v1/claim/status` until `claimed`. Unclaimed mailboxes are deleted after 24 hours.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/claim/challenge` | Get a proof-of-work challenge |
| POST | `/v1/claim` | Claim an address (agent) |
| POST | `/v1/claim/notify` | Email the claim link to a human |
| GET | `/v1/claim/status` | Claim status (agent) |
| GET | `/v1/claim/info` | Claim link details (human) |
| POST | `/v1/claim/accept` | Accept a claim (human) |
| GET | `/v1/claim/unsubscribe` | Stop claim invites (link) |
| POST | `/v1/claim/unsubscribe` | Stop claim invites (RFC 8058 one-click) |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/botmail-pro/openapi/botmail-pro-claim-api-openapi.yml

## Other Botmail APIs (9)

- [Botmail Account API](https://apis.io/apis/botmail-pro/botmail-pro-account-api/)
- [Botmail Billing API](https://apis.io/apis/botmail-pro/botmail-pro-billing-api/)
- [Botmail Events API](https://apis.io/apis/botmail-pro/botmail-pro-events-api/)
- [Botmail Keys API](https://apis.io/apis/botmail-pro/botmail-pro-keys-api/)
- [Botmail Mail API](https://apis.io/apis/botmail-pro/botmail-pro-mail-api/)
- [Botmail Mailboxes API](https://apis.io/apis/botmail-pro/botmail-pro-mailboxes-api/)
- [Botmail Meta API](https://apis.io/apis/botmail-pro/botmail-pro-meta-api/)
- [Botmail Send API](https://apis.io/apis/botmail-pro/botmail-pro-send-api/)
- [Botmail Webhooks API](https://apis.io/apis/botmail-pro/botmail-pro-webhooks-api/)

## Tags

Claim

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/botmail-pro/botmail-pro-claim-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/botmail-pro/.