Graphql Inbox Query
Example GraphQL POST request and response using advanced filters and sorting to retrieve test emails.
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
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
}
]
}
}
}
}
}
Work with this as data
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.
Call it yourself
curl for this page
curl "https://apis.io/api/v1/examples/graphql-inbox-query"
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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.