Use our API to Automate your Testing and QA
Mailinator API Overview
The Mailinator API provides developers and QA teams with a robust RESTful interface for streamlining email and SMS testing workflows. Whether you’re building email-based applications, testing multi-factor authentication systems, or verifying message deliverability, the Mailinator API is designed to simplify your processes with powerful, programmatic access to inboxes and messages.
Why Use the Mailinator API?
-Efficient Inbox Management: Easily retrieve all messages from specific private inboxes to ensure seamless testing for your application.
-Detailed Message Insights: Gain access to comprehensive information about individual messages, including metadata, headers, and content.
-SMS Workflow Integration: Fetch SMS messages sent to designated numbers, perfect for testing OTP systems or other mobile-based workflows.
-Custom Message Injection: Inject messages directly into Mailinator inboxes using HTTP POST requests, enabling end-to-end testing for email systems and workflows.
Key Features
-Private Inbox Access: Manage and analyze messages in secure private inboxes with just a few API calls.
-Private Message Fetching: Dive into specific messages for deeper insights, including attachments and HTML content.
-SMS Testing: Ensure reliability in SMS-based workflows with quick and easy SMS retrieval.
-Message Injection via HTTP POST: Automate the testing of your application’s outbound email systems by programmatically sending messages to your inbox.
Seamless Integration
The Mailinator API is designed to integrate effortlessly into your existing systems. By generating your API token, you can quickly begin automating your email and SMS testing processes. The flexibility of the API allows for smooth integration with CI/CD pipelines, enabling continuous testing and development.
Use Cases
-One-Time Password (OTP) Testing: Simplify the testing of OTP systems used in two-factor and multi-factor authentication.
-Email Receipt Testing: Verify that emails sent from your application are received as intended, with accurate formatting and content.
-Automated Quality Assurance (QA): Enhance your software QA processes by automating email and SMS validation steps.
-Development of Email and SMS Workflows: Build and test robust workflows with reliable access to email and SMS messages.
Getting Started
To use the Mailinator API:
1. Subscribe to a free trial or our Verified Pro plan.
2. Generate your unique API token.
3. Explore the API documentation for endpoints and examples.
Visit our [Mailinator API Documentation] to dive deeper and get started with your integration.
Enhance Your Application Testing Today
The Mailinator API is trusted by thousands of developers and QA professionals for its reliability, scalability, and simplicity. Start leveraging the power of automated email and SMS testing to optimize your workflows and deliver seamless user experiences.
GET /api/v2/domains/private/inboxes/testinbox
{
"domain": "yourprivatedomain.com",
"to": "testinbox"
"msgs": [
{
"subject": "this is a test email 1",
"domain": "yourprivatedomain.com",
"from": "Our Qa Tester <qatester@company.com>"
"id": "testinbox-1571155952-33840774",
"to": "testinbox",
"time": 1571155952000,
"seconds_ago": 258277
},
{
"subject": "This is my test email [with attachment]",
"domain": "yourprivatedomain.com",
"from": "Our Qa Tester <qatester@company.com>"
"id": "testinbox-1570635306-12914603",
"to": "testinbox",
"time": 1570635306000,
"seconds_ago": 778923
}
],
}
}
GET /api/v2/domain/private/inboxes/testinbox/messages/testinbox-157-s8393
{
"fromfull": "Our Qa Tester <qatester@company.com>",
"headers": {
"mime-version": "1.0",
"date": "Tue, 15 Oct 2019 12:12:20 -0400",
"subject": "this is a test email 1",
"content-type": "multipart/mixed",
},
"subject": "this is a test email 1",
"parts": [
{
"headers": {
"content-type": "text/plain; charset=UTF-8"
},
"body": "here is our test email\r\n"
},
],
"from": "Our Qa Tester",
"to": "testinbox",
"id": "testinbox-1570635306-12914603",
"time": 1571155952000,
"seconds_ago": 260276
}
GET /api/v2/domain/private/inboxes/15555555555/messages/15555555555-838-20
{
"fromfull": "4444444444",
"subject": "Here's your 2-factor code!",
"parts": [
{
"body": "Your code is: 382910"
},
],
"to": "15555555555",
"time": 1571155952000,
"seconds_ago": 260276
}
POST https://api.mailinator.com/api/v2/domains/private/inboxes/testinbox/
{"from":"ourtest@xyz.com", "subject":"testing message", "text" : "hello world" }
{
"status" : "ok",
"id" : "testinbox-3282929-109191"
}