---
title: "Email a recovery link to each verified external owner of the inbox address. Returns HTTP 202 with the same body before the lookup and the email when the limit is checked. 5 per hour per IP and 3 per day per address, then HTTP 429 rate_limited. If the limit cannot be checked, the response is HTTP 503 rate_limit_unavailable with Retry-After, retry_after_seconds, and resets_at. An address at cooperemail.com or any subdomain, an inbox on any account, and any domain row are skipped. The key is not emailed."
method: POST
path: "/api/v1/recover"
tags: ["Auth"]
---

# Email a recovery link to each verified external owner of the inbox address. Returns HTTP 202 with the same body before the lookup and the email when the limit is checked. 5 per hour per IP and 3 per day per address, then HTTP 429 rate_limited. If the limit cannot be checked, the response is HTTP 503 rate_limit_unavailable with Retry-After, retry_after_seconds, and resets_at. An address at cooperemail.com or any subdomain, an inbox on any account, and any domain row are skipped. The key is not emailed.

`POST /api/v1/recover`

## Request

- Base URL: `https://cooperemail.com`
- URL: `https://cooperemail.com/api/v1/recover`
- Auth: none required

## Request body

- object
  - `address` string, required: Inbox email address.

## Response `202`

Accepted. The body does not say whether an account exists.

## Other responses

- `429`: rate_limited
- `503`: rate_limit_unavailable. The limit could not be checked. Retry-After, retry_after_seconds, and resets_at.

---

[API](https://skmtc.dev/cooperemail/apis/cooper-email-api.md) · [All operations](https://skmtc.dev/cooperemail/apis/cooper-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cooperemail/apis/cooper-email-api/revisions/6d800a7b3e33?raw)