REST v1
←
PUBLIC API

Read temp mail from scripts.

Open REST API — no key, no login. Grab a mailbox, poll messages, and pick up verification codes.

CORS is open. Call these endpoints from a browser, curl, or any script. Passwords are never returned.

Quick start


    


    

      
Endpoints


      

        
GET /v1/health

        
Service status.

      


      

        
GET /v1/mailbox

        
Random mailbox, or a specific one with ?email=. Returns the full inbox: HTML, text, extracted links, verification codes, and attachments. Add ?refresh=1 to sync now.

      


      

        
GET /v1/inbox?email=

        
Full inbox for one address. Same payload as /v1/messages: every message body, every link, every detected code.

      


      

        
GET /v1/messages?email=

        
Alias of inbox. Each message includes html, text, links, urls, code, and attachments.

      


      

        
GET /v1/links?email=

        
Every link found in the inbox — verify buttons, tracking URLs, images, and plain-text URLs.

      


      

        
GET /v1/message?email=&id=

        
One message with full HTML, text, and links.

      


      

        
POST /v1/refresh?email=

        
Force-sync a mailbox, then return the latest messages.

      


      

        
GET /v1/mailboxes

        
List mailboxes in the pool (no passwords). Optional ?pool=vault.

      


      

        
GET /v1/domains

        
Unique domains in the public pool.

      

    


    

      
JavaScript