The Infrastructure (DMARC) API from Return Path — 10 operation(s) for infrastructure (dmarc).
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.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.curl "https://apis.io/api/v1/apis/return-path-infrastructure-dmarc-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
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.
openapi: 3.2.0
info:
title: Everest Infrastructure (DMARC) API
version: '2.0'
summary: Email deliverability, inbox placement, sender reputation and DMARC intelligence — the Validity Everest API, the surviving surface of the Return Path platform.
description: 'API Limit: 500 requests per minute. Limit increases are available on a per-customer basis by contacting our support team.
Welcome to the Everest API (V2) by Validity. We''ll be rolling out additional product support in the coming months. It''s important to note that V2 of our API is purely optional. We hope you find it simpler to use, more intuitive, and better documented, but we plan to continue supporting API V1.
All API requests utilize REST methods resulting in JSON, XML, CSV, or Serialized output. To request new API functionality please feel free to contact us.
Every API request requires the use of the X-API-KEY header, which is located in your account settings.
Throughout the documentation you''ll see the use of variables like YOUR_API_KEY that can be swapped out using your real API key. If you use Postman, this collection is available for download along with a shared variable template to define your host and apikey variables.
All datetime fields are UTC.
Standard API Responses
200 Success
401 Unauthorized (no valid API key provided)
403 Forbidden (indicates lack access to the action you''re performning)
404 Not Found (indicates invalid parameters or missing API endpoint)
429 Too Many Requests (API limits have been reached, retry after some time)
500 Internal Server Error (indicates something went wrong on our end)
Each 400-level error code will contain an status object containing a description of the problem.'
contact:
name: Validity Support
url: https://knowledge.validity.com/
x-derived-from: collections/return-path-everest-api.postman_collection.json
x-source-url: https://developer.everest.validity.com/
x-provenance: DERIVED by API Evangelist from the Postman collection Validity publishes at developer.everest.validity.com. Validity does not publish an OpenAPI document; every path, method, parameter, header, request body and response example here is read verbatim from that collection.
servers:
- url: https://api.everest.validity.com/api
description: 'Everest API. The major version is the first path segment: 2.0 is current, 1.0 is the legacy API Validity says it will continue to support.'
security:
- apiKeyAuth: []
tags:
- name: Infrastructure (DMARC)
paths:
/2.0/infrastructure/domains:
get:
operationId: domainsPolicies
summary: Domains & Policies
tags:
- Infrastructure (DMARC)
x-api-version: '2.0'
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
meta:
type: object
properties:
params:
type: object
properties:
startdate:
type: string
enddate:
type: string
page:
type: integer
limit:
type: integer
forwarded: {}
classification: {}
ip: {}
mailorigin: {}
spfdomain: {}
dkimdomain: {}
spfresult: {}
dkimresult: {}
total:
type: integer
pages:
type: integer
results:
type: array
items:
type: object
properties:
domain:
type: string
policy:
type: string
volume:
type: object
properties:
total:
type: integer
compliant:
type: integer
noncompliant:
type: integer
unauthenticated:
type: integer
compliance:
type: object
properties:
compliant:
type: integer
noncompliant:
type: integer
unauthenticated:
type: integer
spf:
type: object
properties:
record:
type: string
pass:
type: integer
aligned:
type: integer
dkim:
type: object
properties:
pass:
type: integer
aligned:
type: integer
reports:
type: string
examples:
Domains Policies:
value:
meta:
params:
startdate: '2021-01-04T00:00:00+00:00'
enddate: '2021-02-02T00:00:00+00:00'
page: 1
limit: 100
forwarded: null
classification: null
ip: null
mailorigin: null
spfdomain: null
dkimdomain: null
spfresult: null
dkimresult: null
total: 15
pages: 1
results:
- domain: domain.com
policy: reject
volume:
total: 2617
compliant: 2450
noncompliant: 0
unauthenticated: 167
compliance:
compliant: 94
noncompliant: 0
unauthenticated: 6
spf:
record: v=spf1 include:_spf.google.com ~all
pass: 94
aligned: 93
dkim:
pass: 94
aligned: 94
reports: dmarc_fr@domain.com
'401':
description: Unauthorized — no valid API key provided
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden — the key lacks access to this action
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found — invalid parameters or missing API endpoint
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Too Many Requests — API rate limit reached, retry later
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
post:
operationId: createDomain
summary: Create Domain
tags:
- Infrastructure (DMARC)
x-api-version: '2.0'
requestBody:
required: true
content:
multipart/form-data:
schema:
type: object
properties:
domain:
type: string
example:
domain: domain.com
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
meta:
type: object
results:
type: object
properties:
domain:
type: string
status:
type: string
examples:
Create Domain:
value:
meta: {}
results:
domain: domain.com
status: success
'401':
description: Unauthorized — no valid API key provided
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden — the key lacks access to this action
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found — invalid parameters or missing API endpoint
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Too Many Requests — API rate limit reached, retry later
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/2.0/infrastructure/domains/{domain}:
get:
operationId: domainOverview
summary: Domain - Overview
tags:
- Infrastructure (DMARC)
x-api-version: '2.0'
parameters:
- name: domain
in: path
required: true
schema:
type: string
example: domain.com
responses:
'200':
description: Success
'401':
description: Unauthorized — no valid API key provided
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden — the key lacks access to this action
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found — invalid parameters or missing API endpoint
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Too Many Requests — API rate limit reached, retry later
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
delete:
operationId: deleteDomain
summary: Delete Domain
tags:
- Infrastructure (DMARC)
x-api-version: '2.0'
parameters:
- name: domain
in: path
required: true
schema:
type: string
example: domain.com
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
meta:
type: object
results:
type: object
properties:
domain:
type: string
status:
type: string
examples:
Delete Domain:
value:
meta: {}
results:
domain: domain.com
status: success
'401':
description: Unauthorized — no valid API key provided
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden — the key lacks access to this action
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found — invalid parameters or missing API endpoint
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Too Many Requests — API rate limit reached, retry later
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/2.0/infrastructure/domains/{domain}/mailorigins:
get:
operationId: domainMailOrigins
summary: Domain - Mail Origins
tags:
- Infrastructure (DMARC)
x-api-version: '2.0'
parameters:
- name: domain
in: path
required: true
schema:
type: string
example: domain.com
- name: classification
in: query
required: false
schema:
type: string
example: compliant
responses:
'200':
description: OK
content:
text/plain:
example: "{\n \"meta\": {\n \"params\": {\n \"classification\": [\n \"compliant\",\n \"unauthenticated\",\n \"non-compliant\"\n ],\n \"startdate\": \"2021-01-04T00:00:00+00:00\",\n \"enddate\": \"2021-02-02T00:00:00+00:00\",\n \"page\": 1,\n \"limit\": 100,\n \"forwarded\": null,\n \"ip\": null,\n \"mailorigin\": null,\n \"spfdomain\": null,\n \"dkimdomain\": null,\n \"spfresult\": null,\n \"dkimresult\": null,\n \"country\": null,\n \"region\": null,\n \"city\": null\n },\n \"pages\": 76,\n \"next\": \"/api/2.0/infrastructure/domains/domain.com/mailorigins/?page=2&classification[]=compliant&forwarded=exclude\",\n \"total\": 7556\n },\n \"results\": [\n {\n \"rdns\": \"*.domain.com\",\n \"category\": \"\",\n \"organization\": \"\",\n \"volume\": 16343130518\n },\n {\n \"rdns\": \"*.gmail.com\",\n \"category\": \"Webmail\",\n \"organization\": \"Google\",\n \"volume\": 20636945\n },\n {\n \"rdns\": \"*.amazonses.com\",\n \"category\": \"ESP\",\n \"organization\": \"Amazon SES\",\n \"volume\": 5675516\n }, ...\n ]\n}"
'401':
description: Unauthorized — no valid API key provided
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden — the key lacks access to this action
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found — invalid parameters or missing API endpoint
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Too Many Requests — API rate limit reached, retry later
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/2.0/infrastructure/domains/{domain}/ip:
get:
operationId: domainIPAddresses
summary: Domain - IP Addresses
tags:
- Infrastructure (DMARC)
x-api-version: '2.0'
parameters:
- name: domain
in: path
required: true
schema:
type: string
example: domain.com
responses:
'200':
description: OK
content:
text/plain:
example: "{\n \"meta\": {\n \"params\": {\n \"startdate\": \"2021-01-04T00:00:00+00:00\",\n \"enddate\": \"2021-02-02T00:00:00+00:00\",\n \"page\": 1,\n \"limit\": 100,\n \"forwarded\": null,\n \"classification\": null,\n \"ip\": null,\n \"mailorigin\": null,\n \"spfdomain\": null,\n \"dkimdomain\": null,\n \"spfresult\": null,\n \"dkimresult\": null,\n \"country\": null,\n \"region\": null,\n \"city\": null\n },\n \"total\": 50189,\n \"pages\": 502\n },\n \"results\": [\n {\n \"ip\": \"127.0.0.1\",\n \"rdns\": \"mta-1.domain.com\",\n \"organization\": \"Contextlogic Inc\",\n \"volume\": 188678452,\n \"geolocation\": {\n \"country\": \"US\",\n \"state\": \"New Jersey\",\n \"city\": \"Newark\"\n }\n },\n {\n \"ip\": \"127.0.0.2\",\n \"rdns\": \"mta-2.domain.com\",\n \"organization\": \"Contextlogic Inc\",\n \"volume\": 188664694,\n \"geolocation\": {\n \"country\": \"US\",\n \"state\": \"New Jersey\",\n \"city\": \"Newark\"\n }\n },\n {\n \"ip\": \"127.0.0.3\",\n \"rdns\": \"mta-3.domain.com\",\n \"organization\": \"Contextlogic Inc\",\n \"volume\": 188662548,\n \"geolocation\": {\n \"country\": \"US\",\n \"state\": \"New Jersey\",\n \"city\": \"Newark\"\n }\n }, ...\n ]\n}"
'401':
description: Unauthorized — no valid API key provided
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden — the key lacks access to this action
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found — invalid parameters or missing API endpoint
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Too Many Requests — API rate limit reached, retry later
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/2.0/infrastructure/domains/{domain}/spfdomains:
get:
operationId: domainSPFDomains
summary: Domain - SPF Domains
tags:
- Infrastructure (DMARC)
x-api-version: '2.0'
parameters:
- name: domain
in: path
required: true
schema:
type: string
example: domain.com
- name: limit
in: query
required: false
schema:
type: string
example: '10'
- name: page
in: query
required: false
schema:
type: string
example: '1'
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
meta:
type: object
properties:
params:
type: object
properties:
limit:
type: integer
page:
type: integer
startdate:
type: string
enddate:
type: string
forwarded: {}
classification: {}
ip: {}
mailorigin: {}
spfdomain: {}
dkimdomain: {}
spfresult: {}
dkimresult: {}
country: {}
region: {}
city: {}
total:
type: integer
pages:
type: integer
results:
type: array
items:
type: object
properties:
domain:
type: string
policy_domain:
type: string
organization:
type: string
volume:
type: integer
examples:
Domain - SPF Domains:
value:
meta:
params:
limit: 5
page: 1
startdate: '2021-01-04T00:00:00+00:00'
enddate: '2021-02-02T00:00:00+00:00'
forwarded: null
classification: null
ip: null
mailorigin: null
spfdomain: null
dkimdomain: null
spfresult: null
dkimresult: null
country: null
region: null
city: null
total: 36429
pages: 3643
results:
- domain: mail.domain.com
policy_domain: domain.com
organization: Contextlogic Inc
volume: 15158170388
- domain: mail.domain.com
policy_domain: domain.com
organization: ''
volume: 1871480439
- domain: gmail.com
policy_domain: domain.com
organization: Google LLC
volume: 14199273
- domain: amazonses.com
policy_domain: domain.com
organization: Amazon Web Services, Inc.
volume: 5352038
- domain: domain.wish.com
policy_domain: domain.com
organization: Google LLC
volume: 3754571
'401':
description: Unauthorized — no valid API key provided
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden — the key lacks access to this action
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found — invalid parameters or missing API endpoint
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Too Many Requests — API rate limit reached, retry later
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/2.0/infrastructure/domains/{domain}/dkimdomains:
get:
operationId: domainDKIMDomains
summary: Domain - DKIM Domains
tags:
- Infrastructure (DMARC)
x-api-version: '2.0'
parameters:
- name: domain
in: path
required: true
schema:
type: string
example: domain.com
- name: limit
in: query
required: false
schema:
type: string
example: '5'
- name: page
in: query
required: false
schema:
type: string
example: '1'
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
meta:
type: object
properties:
params:
type: object
properties:
limit:
type: integer
page:
type: integer
startdate:
type: string
enddate:
type: string
forwarded: {}
classification: {}
ip: {}
mailorigin: {}
spfdomain: {}
dkimdomain: {}
spfresult: {}
dkimresult: {}
country: {}
region: {}
city: {}
total:
type: integer
pages:
type: integer
results:
type: array
items:
type: object
properties:
signing_domain:
type: string
policy_domain:
type: string
organization:
type: string
volume:
type: integer
examples:
Domain - DKIM Domains:
value:
meta:
params:
limit: 5
page: 1
startdate: '2021-01-04T00:00:00+00:00'
enddate: '2021-02-02T00:00:00+00:00'
forwarded: null
classification: null
ip: null
mailorigin: null
spfdomain: null
dkimdomain: null
spfresult: null
dkimresult: null
country: null
region: null
city: null
total: 36429
pages: 3643
results:
- signing_domain: mail.domain.com
policy_domain: domain.com
organization: Contextlogic Inc
volume: 15158170388
- signing_domain: mail.domain.com
policy_domain: domain.com
organization: ''
volume: 1871480439
- signing_domain: gmail.com
policy_domain: domain.com
organization: Google LLC
volume: 14199273
- signing_domain: amazonses.com
policy_domain: domain.com
organization: Amazon Web Services, Inc.
volume: 5352038
- signing_domain: domain.wish.com
policy_domain: domain.com
organization: Google LLC
volume: 3754571
'401':
description: Unauthorized — no valid API key provided
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'403':
description: Forbidden — the key lacks access to this action
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'404':
description: Not Found — invalid parameters or missing API endpoint
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'429':
description: Too Many Requests — API rate limit reached, retry later
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
'500':
description: Internal Server Error
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
/2.0/infrastructure/domains/{domain}/spfresults:
get:
operationId: domainAuthenticationIssuesSPF
summary: 'Domain - Authentication Issues: SPF'
tags:
- Infrastructure (DMARC)
x-api-version: '2.0'
parameters:
- name: domain
in: path
required: true
schema:
type: string
example: domain.com
responses:
'200':
description: OK
content:
application/json:
schema:
type: object
properties:
meta:
type: object
properties:
params:
type: object
properties:
startdate:
type: string
enddate:
type: string
page:
type: integer
limit:
type: integer
forwarded: {}
classification: {}
ip: {}
mailorigin: {}
spfdomain: {}
dkimdomain: {}
spfresult: {}
dkimresult: {}
country: {}
region: {}
city: {}
results:
type: array
items:
type: object
properties:
day:
type: string
none:
type: integer
pass:
type: integer
fail:
type: integer
softfail:
type: integer
temperror:
type: integer
permerror:
type: integer
examples:
Domain - Authentication Issues SPF:
value:
meta:
params:
startdate: '2021-01-05T00:00:00+00:00'
enddate: '2021-02-03T00:00:00
# --- truncated at 32 KB (70 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/return-path/refs/heads/main/openapi/return-path-infrastructure-dmarc-api-openapi.yml