Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Testmail Inbox API

Retrieve test emails from programmable inboxes

Testmail Inbox API is one of 2 APIs that Testmail publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Inbox. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 1 operation across 1 path, and defines 4 schemas. It is described by OpenAPI 3.0.3, at version 1.0.0.

Requests are made against a single base URL, https://api.testmail.app/api.

1 operations 1 paths 4 schemas 1 GET

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.0.0
Base URL
https://api.testmail.app/api/json
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Testmail Inbox API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). By default, every request must be authenticated.

  • BearerAuth — API key as Bearer token. Obtain from the Testmail developer console and pass as: Authorization: Bearer YOURAPIKEY

Paths & Operations 1

Across 1 path, the API surfaces 1 operation — 1 GET. Each is listed below with its method, path, parameters, and response codes.

Inbox 1

Retrieve test emails from programmable inboxes

GET
/json
Retrieve emails from a namespace inbox
getEmails 12 params → 200307400401429

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are Email (10 properties), EmailListResponse (6 properties), ErrorResponse (2 properties), EmailHeader (2 properties). Each schema is shown below with its type and property counts.

EmailListResponse
object
Response envelope for a list of emails.
6 properties 5 required
EmailHeader
object
A single raw email header line.
2 properties
Email
object
A single test email retrieved from a Testmail inbox.
10 properties
ErrorResponse
object
Error response envelope.
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

testmail-app-inbox-api-openapi.yml Raw ↑

Other APIs Testmail publishes across the network.

Testmail GraphQL API