API Documentation: justemail.work

GET
Open to Everyone No API key Strict Rate Limits Test & Low-Volume
  • Retrieve messages for any alias using a GET request.
  • Best for temporary, disposable usage like email verification or throwaway accounts.
  • Access and history are limited. Anyone can read any alias.
Parameters:
  • mailbox (required): The alias, e.g. foo for foo@justemail.work
Usage Example: 
GET https://justemail.work/getinbox.php?mailbox=YOUR_ALIAS
Response: JSON array of emails.
⚠️ Public API is heavily rate-limited. Do not use in production or for automation.

Response Format

  • Success Returns a JSON array of email objects.
  • Error Returns HTTP 4xx or 5xx with {"error":"..."}.
Field Descriptions:
  • id – Unique ID of the message
  • from – Email sender's address
  • subject, date – Subject line & timestamp
  • snippet – Short preview
  • body – Full message content (may be partial)
  • headers – Basic headers for the message
[
  {
    "timestamp": "",
    "success": true,
    "emails": [
      {
        "timestamp": "",
        "to": [
          ""
        ],
        "cc": [],
        "bcc": [],
        "reply_to": [
          ""
        ],
        "from": [
          ""
        ],
        "from_name": "",
        "from_email": "",
        "subject": "",
        "date": "",
        "body": "",
        "message_id": "",
        "in_reply_to": "",
        "references": "",
        "importance": "",
        "email_uid": 7
      }
    ],
    "error": null
  }
]

How Access Levels Work

Public GET
  • Any script/app can GET ?mailbox=foo
  • Non-commercial/light use only
  • Strictly rate-limited, short history
Private POST
  • API key required in POST body
  • Greater access, longer message retention
  • Faster responses, best for integration
Note: Public GET access is only suited for testing & personal/light use. For business/automation you must use POST access + API key.

Limitations & Fair Use

Public
  • Strict rate limits; repetitive usage throttled/blocked
  • Mailboxes/aliases NOT reserved (open to all)
  • No privacy guarantee (shared public pool)
Private
  • Priority rate limits, more history
  • For business, production, integration
  • Analytics and reporting
  • Request an API key for premium/enterprise

Requesting API Access

Request API Access Back to Home