Home
Testmail
Graphql Inbox Query
Graphql Inbox Query
Example GraphQL POST request and response using advanced filters and sorting to retrieve test emails.
Email Testing Developer Tools API Testing GraphQL REST API CI/CD QA Automation Programmable Inboxes
Graphql Inbox Query is an example object payload from Testmail, with 4 top-level fields. It illustrates the shape of data this provider's APIs accept or return.
Top-level fields
title description request response
Example Payload
{
"title": "GraphQL API - Inbox query with advanced filters",
"description": "Example GraphQL POST request and response using advanced filters and sorting to retrieve test emails.",
"request": {
"method": "POST",
"url": "https://api.testmail.app/api/graphql",
"headers": {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json"
},
"body": {
"query": "query GetInbox($ns: String!) { inbox(namespace: $ns, advanced_filters: [{ field: \"subject\", match: \"wildcard\", action: \"include\", value: \"Verify*\" }], advanced_sorts: [{ field: \"timestamp\", order: \"desc\" }], limit: 10) { result count emails { from from_parsed { address name } to subject text tag timestamp spam_score } } }",
"variables": {
"ns": "mynamespace"
}
}
},
"response": {
"status": 200,
"headers": {
"Content-Type": "application/json"
},
"body": {
"data": {
"inbox": {
"result": "success",
"count": 3,
"emails": [
{
"from": "no-reply@myapp.com",
"from_parsed": {
"address": "no-reply@myapp.com",
"name": "My App"
},
"to": "mynamespace.verify-user789@inbox.testmail.app",
"subject": "Verify your new email address",
"text": "Please verify: https://myapp.com/verify/token789",
"tag": "verify-user789",
"timestamp": 1686003000000.0,
"spam_score": 0.5
},
{
"from": "no-reply@myapp.com",
"from_parsed": {
"address": "no-reply@myapp.com",
"name": "My App"
},
"to": "mynamespace.verify-user456@inbox.testmail.app",
"subject": "Verify your account",
"text": "Please verify: https://myapp.com/verify/token456",
"tag": "verify-user456",
"timestamp": 1686001000000.0,
"spam_score": 0.5
},
{
"from": "no-reply@myapp.com",
"from_parsed": {
"address": "no-reply@myapp.com",
"name": "My App"
},
"to": "mynamespace.verify-user123@inbox.testmail.app",
"subject": "Verify your email address",
"text": "Please verify: https://myapp.com/verify/token123",
"tag": "verify-user123",
"timestamp": 1686000000000.0,
"spam_score": 0.5
}
]
}
}
}
}
}
Every example here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for examples
4 MCP tools reach this
find_examplesBrowse and filter every example in the catalog.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.
All 92 tools
Call it yourself
curl for this page
This example
curl "https://apis.io/api/v1/examples/graphql-inbox-query"
All examples
curl "https://apis.io/api/v1/examples?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no email required.
A second provider on the same verified email joins the account you already have.