AI-Friendly Docs
Plain-text API reference. Share the link with AI assistants to help write integration code.
/llm-api-docs.txt
General Information
https://api.duckmail.sbs
Authentication
Bearer Token
Public domain listing and public temporary account creation allow anonymous access. After creating an account, call POST /token separately to obtain a mailbox token. Mail access uses a Bearer Token; owners can also exchange an API Key for a hosted mailbox token.
API Key
One API Key accesses all your private domains and hosted mailboxes, including account creation and hosted mailbox management. The key starts with `dk_`. Listing, importing, and managing Microsoft hosted mailboxes requires the key. GET /domains and creating a temporary mailbox only need it for private domains. You can obtain your API Key from https://domain.duckmail.sbs.
Rate Limits and Retries
Current direct API limits per IP: 1,000 requests/second with a valid token or API Key; 1,000 without authentication, except account creation at 200 requests/second. Persistent invalid requests may be temporarily restricted.
On 429, wait for the number of seconds specified by Retry-After before retrying. Poll every 2 seconds and avoid duplicate requests.
Error Handling
400/403/422: check parameters or permissions; 401: check your login; 404/410: refresh the list; 424: renew Microsoft authorization.
API Endpoints
Contributions
We welcome developers to create integrations, libraries, and tools for the DuckMail API. If you have any contributions, feel free to contact us or submit a pull request on our GitHub repository.