API Documentation
Postman Collection
Try our API interactively with our ready-to-use Postman collection:
docs.tigrmail.comBase URL
https://api.tigrmail.comAuthentication
All API requests require authentication via Bearer token in the Authorization header:
Authorization: Bearer YOUR_API_TOKENError Handling
Server errors (5xx): We get immediately notified and start investigating. You can reach out via live chat at tigrmail.com or email support@tigrmail.com
User errors (4xx): Contain human-readable description of what went wrong
Error format:
{
"code": "no_message",
"error": "no new messages"
}Endpoints
Create Inbox
/v1/inboxesCreate an inbox (email address) that you can use to send emails to from your app. Only you have access to your inboxes and only you can receive messages from them. It's ok to create a new inbox for each new test run.
Parameters
domainOptional| Name | Type | Required | Description |
|---|---|---|---|
domain | string | Optional | Optional domain to use for the generated inbox. Use /v1/domains to list available domains. |
Response Format
{
"inbox": "string (email address to send email to)"
}Example Response
{
"inbox": "ornery-pixie-bob-f6m0fysfa212cnvr242r@den.tigrmail.com"
}List Domains
/v1/domainsList the inbox domains available for your account. Pass one of these values as the optional domain query parameter when creating an inbox.
Response Format
{
"domains": "array[string] (available inbox domains)"
}Example Response
{
"domains": [
"den.tigrmail.com"
]
}Poll Next Message
/v1/messagesPoll the next email message for the given inbox. The message that gets received gets automatically marked as received and will not be returned in future calls. If no message has arrived within 3 minutes, an error will be returned.
Parameters
inboxRequiredsubjectEqualsOptionalsubjectContainsOptionalfromEmailOptionalfromDomainOptional| Name | Type | Required | Description |
|---|---|---|---|
inbox | string | Required | Email inbox for polling the new message |
subjectEquals | string | Optional | Poll message only with precisely specified subject. Case insensitive. Can't be used if subjectContains is specified. |
subjectContains | string | Optional | Poll message that contains provided substring. Case insensitive. Can't be used if subjectEquals is specified. |
fromEmail | string | Optional | Poll messages only from a specified sender. |
fromDomain | string | Optional | Poll messages only from a specified domain. |
Response Format
{
"message": {
"to": "array[string] (list of recipients from the original email)",
"from": "string (original sending email address)",
"subject": "string (email subject from the original email)",
"body": "string (contents of the email. If multipart, text attachments rendered inline, binary attachments replaced with {attachments[0]} placeholders)"
}
}Example Response
{
"message": {
"to": [
"ornery-pixie-bob-f6m0fysfa212cnvr242r@tigrmail.com"
],
"from": "no-reply@yourapp.com",
"subject": "Verification Code",
"body": "Use this code to confirm your sign-up: 918642"
}
}Important Notes:
- • Messages are automatically marked as received after polling
- • Polling will block for up to 3 minutes waiting for messages
- • Multipart messages: text attachments are inlined, binary attachments become placeholders
- • You can filter messages by subject, sender email, or sender domain
- • Each inbox is private to your account