← Back to App

Developer API

Use the GET API to create temp mails and read emails from your bots or apps. All queries use ?action=NAME format.

Authentication header

A header is extra information sent with the request, separate from the URL. It has a name and a value. Every API call must include this header. Requests without it return Unauthorized.

Header name: Authorization

Header value: the private token you were given. It is not published here. In the examples below, replace YOUR_TOKEN with that token.

X-Api-Key works the same way if you prefer that header name.

curl -H "Authorization: YOUR_TOKEN" "https://email.yamin.bd/?action=getMessages&user=alex&domain=fastmailshop.com"

Supported domains: @epicz.xyz, @fastmailshop.com, @gshopt.com, @liseller.net, @llsz.xyz, @nitcy.site, @tplink.info, @yamin.bd. Choose the inbox with user=name@fastmailshop.com or user=name&domain=fastmailshop.com. The same pattern works for every domain above. Without a domain, @epicz.xyz is used. Domains turned off in admin are left out of this list and are rejected.

GET ?action=status

Check that the service is online.

GET ?action=getDomains

List the supported domains.

GET ?action=genRandom

Generates a random username.

GET ?action=getMessages&user=USERNAME&domain=DOMAIN

Fetch latest 50 messages for that address.

GET ?action=readMessage&user=USERNAME&domain=DOMAIN&id=MESSAGE_ID

Read specific message HTML body and extracted codes.

GET ?action=deleteSingleMessage&user=USERNAME&domain=DOMAIN&id=MESSAGE_ID

Delete one message.

GET ?action=deleteInbox&user=USERNAME&domain=DOMAIN

Permanently clear the inbox for that address.