Inbox placement test API
deliverability.inbox_placement
- providers document it
- 9
Providers
9 providers document inbox placement test in their own API docs. None routes it through GridRouter yet. Scores appear as calls are routed.

AWS Simple Email Service for high-volume sending.

Inbox placement testing, DMARC analytics and an API.

Spam score testing with a JSON API.

Sinch's transactional email API with US and EU regions.

Email warmup and spam tester with an API and MCP.
Bird's email delivery API with US and EU endpoints.
Email deliverability management and placement tests.

Email deliverability, inbox placement and reputation monitoring.

Email warmup and inbox placement testing.
- What counts as a hit:
- A placement result is returned for every seed.
API
Same input for every provider. Set provider.sort to route by price, reliability or latency, or provider.only to pin providers; X-Grid-Max-Cost caps what one call can spend.
| Input | Description |
|---|---|
| from_domain* | Sending domain (required) |
curl https://api.gridrouter.io/v1/run/deliverability.inbox_placement \
-H "Authorization: Bearer $GRID_API_KEY" \
-H "Content-Type: application/json" \
-H "X-Grid-Max-Cost: 0.05" \
-d '{"input":{"from_domain":"northwind.dev"},"provider":{"sort":"price"}}'Fields
The normalized output every provider maps into. Suppliers come from integrated endpoint mappings (verified) or field names in each provider's API docs (claimed by the provider).
| Field | Type | PII | Description | Supplied by |
|---|---|---|---|---|
| provider | string | None | Mailbox provider (Gmail, Outlook…) | Not mapped yet |
| placement | string | None | inbox, promotions or spam | Not mapped yet |
| seed_email | string · email | Business contact | Seed address | Not mapped yet |
| from_domain | string · domain | None | Sending domain | Not mapped yet |