PhantomSign

PhantomSign | Temporary Email & Verification Code Extraction API is a temporary email service designed to create short-lived inboxes (valid for up to 5 minutes) for signup verification and other verification flows. It provides an API to programmatically generate inboxes, poll for verification codes or links, and delete inboxes. The service emphasizes quick access to disposable emails and streamlined extraction of verification content from incoming messages.

---

How it works

1. Generate an inbox. Create a temporary email address that remains active for up to 5 minutes.
2. Use the email for signups. Use the generated address to sign up for services that require email verification.
3. Poll for content. PhantomSign can extract verification codes or links from the verification emails and present them to you directly.
4. Manage inboxes. Poll, retrieve content, or delete the inbox when done.

---

API at a glance

• All API requests require a valid API key provided in the header as x-api-key.

• Rate limit: 20 requests per minute per IP.

• Endpoints:

• POST /api/generate-inbox — Create a new inbox. Response includes the inbox email.

• GET /api/poll-inbox?inbox=[email] — Check the inbox for content. Possible responses:

• 200 with { "message": "Awaiting email" }

• 200 with { "code": [Verification code], "company": [Company name] }

• 200 with { "link": [Verification link], "company": [Company name] }

• 200 with { "message": "Email lacks content" }

• 400/404/401/403/Other errors as described in the spec

• DELETE /api/delete-inbox?inbox=[email] — Delete the inbox. Returns a confirmation message on success.

• Response examples indicate field names like inbox, code, company, and link depending on the data detected in the email.

• API key management and error handling are described in the responses section, with standard HTTP status codes.

---

How to Use PhantomSign API

• Obtain your API key from PhantomSign.
• Create an inbox with POST /api/generate-inbox.
• Use the provided inbox address for signups.
• Periodically poll the inbox via GET /api/poll-inbox?inbox=[email] until you receive a verification code or link.
• When finished, delete the inbox with DELETE /api/delete-inbox?inbox=[email].

---

Security & Compliance Considerations

• Use for legitimate verification workflows only. Respect terms of service of target sites and avoid abuse.
• The service is designed for ephemeral use; manage expiry times accordingly.

---

Core Features

• Temporary email addresses valid for up to 5 minutes
• Create inboxes via a simple API key authenticated interface
• Automatic extraction of verification codes or links from incoming emails
• Polling endpoint to retrieve codes, links, or status messages
• Inbox deletion to clean up resources
• Clear error handling for common scenarios (inbox not found, missing inbox, API key errors)