Skip to content
2b4d Docs

2b4d Temp Mail API

The Temp Mail API lets you create a temporary address, receive messages through Cloudflare Email Routing, read message summaries, fetch sanitized message detail, and clear an inbox for your current API session.

Base URL:

https://2b4d.org

Supported mail domains:

  • fuckemail.org
  • g3m4.dev
  • shineshop.store
  • freelet.org

Session model

Section titled “Session model”

The API is intentionally session-scoped.

  1. Call POST /api/tempmail/address to create or claim an address.
  2. Store the returned Set-Cookie values (tm_session and tm_nonce).
  3. Send the Cookie header on inbox, message, and clear requests.

No public CORS headers are emitted. Browser integrations should call the API from the same origin or proxy it through their own backend.

Quick start

Section titled “Quick start”
Terminal window
curl -i https://2b4d.org/api/tempmail/address \
  -H "Content-Type: application/json" \
  --data '{"random":true,"domain":"g3m4.dev","algorithm":"compact"}'

Save the cookies from the response, then poll the inbox:

Terminal window
curl https://2b4d.org/api/tempmail/inbox?email=YOUR_EMAIL \
  -H "Cookie: tm_session=...; tm_nonce=..."

Retention

Section titled “Retention”

Messages expire after 24 hours. Each inbox response returns only currently visible, non-expired messages for the current session.

API reference

Section titled “API reference”

See Endpoints for request and response shapes.

AI-readable docs

Section titled “AI-readable docs”

For AI agents and coding assistants, the same API contract is available as plain text: