# Return Path Inbox Placement API

**Canonical:** https://apis.io/apis/return-path/return-path-inbox-placement-api/  
**Provider:** Return Path — https://apis.io/providers/return-path/  
**Base URL:** https://api.everest.validity.com/api  
**Documentation:** https://developer.everest.validity.com/

Return Path Inbox Placement API is one of 11 APIs that [Return Path](https://apis.io/providers/return-path/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Inbox Placement. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The Inbox Placement API from Return Path — 17 operation(s) for inbox placement.

## Operations (22)

| Method | Path | Summary |
|---|---|---|
| GET | `/2.0/inbox/seeds` | Seed List |
| PUT | `/2.0/inbox/seeds` | Update Seed List |
| GET | `/2.0/inbox/seeds/providers` | Regions & Providers |
| GET | `/2.0/inbox/optimizer` | All Lists |
| POST | `/2.0/inbox/optimizer` | Create List |
| GET | `/2.0/inbox/optimizer/{optimizerId}` | List by ID |
| DELETE | `/2.0/inbox/optimizer/{optimizerId}` | Delete List |
| PUT | `/2.0/inbox/optimizer/{optimizerId}` | Apply List Weighting |
| GET | `/2.0/inbox/optimizer/{optimizerId}/domains/{domainId}` | Domains by List |
| GET | `/2.0/inbox/tests` | All Inbox Tests |
| GET | `/2.0/inbox/tests/{testId}` | Inbox Test by ID |
| DELETE | `/2.0/inbox/tests/{testId}` | Delete Test |
| GET | `/2.0/inbox/tests/{testId}/message` | Inbox Test: Full Message |
| GET | `/2.0/inbox/tests/{testId}/providers` | Inbox Test: All Providers |
| GET | `/2.0/inbox/tests/{testId}/providers/{providerId}` | Inbox Test: Provider by ID |
| GET | `/2.0/inbox/tests/{testId}/providers/{providerId}/headers/{headerId}` | Inbox Test: Headers by Mailbox ID |
| GET | `/2.0/inbox/aggregates/region` | Inbox Placement: Region |
| GET | `/2.0/inbox/aggregates/b2b` | Inbox Placement: B2B |
| GET | `/2.0/inbox/aggregates/b2c` | Inbox Placement: B2C |
| GET | `/2.0/inbox/aggregates/fromdomain` | Inbox Placement: From Domain |
| GET | `/2.0/inbox/aggregates/fromaddress` | Inbox Placement: From Address |
| GET | `/2.0/inbox/health` | Mailbox Provider Health |

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/return-path/refs/heads/main/openapi/return-path-inbox-placement-api-openapi.yml
- **Postman** — https://raw.githubusercontent.com/api-evangelist/return-path/refs/heads/main/collections/return-path-everest-api.postman_collection.json
- **Documentation** — https://developer.everest.validity.com/
- **APIReference** — https://developer.everest.validity.com/

## Other Return Path APIs (10)

- [Return Path Account Services API](https://apis.io/apis/return-path/return-path-account-services-api/)
- [Return Path Apps & Integrations API](https://apis.io/apis/return-path/return-path-apps-integrations-api/)
- [Return Path Certification API](https://apis.io/apis/return-path/return-path-certification-api/)
- [Return Path Competitive Intel API](https://apis.io/apis/return-path/return-path-competitive-intel-api/)
- [Return Path Engagement API](https://apis.io/apis/return-path/return-path-engagement-api/)
- [Return Path Infrastructure (DMARC) API](https://apis.io/apis/return-path/return-path-infrastructure-dmarc-api/)
- [Return Path Legacy API (1.0) API](https://apis.io/apis/return-path/return-path-legacy-api-1-0-api/)
- [Return Path List Validation API](https://apis.io/apis/return-path/return-path-list-validation-api/)
- [Return Path Reputation API](https://apis.io/apis/return-path/return-path-reputation-api/)
- [Return Path View Time Optimization API](https://apis.io/apis/return-path/return-path-view-time-optimization-api/)

## Tags

Inbox Placement

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/return-path/return-path-inbox-placement-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/return-path/.