🌐
English

API Documentation

Postman Collection

Try our API interactively with our ready-to-use Postman collection:

docs.tigrmail.com

Base URL

https://api.tigrmail.com

Authentication

All API requests require authentication via Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Error 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

POST/v1/inboxes

Create 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
Type: string
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

GET/v1/domains

List 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

GET/v1/messages

Poll 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

inboxRequired
Type: string
Email inbox for polling the new message
subjectEqualsOptional
Type: string
Poll message only with precisely specified subject. Case insensitive. Can't be used if subjectContains is specified.
subjectContainsOptional
Type: string
Poll message that contains provided substring. Case insensitive. Can't be used if subjectEquals is specified.
fromEmailOptional
Type: string
Poll messages only from a specified sender.
fromDomainOptional
Type: string
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