The dmarced API is a RESTful JSON application programming interface (API) for monitoring and managing email authentication at scale. It provides programmatic access to DMARC reporting, DNS monitoring, and policy configuration, enabling you to analyze email traffic sources and ensure domain compliance.

Specification

The dmarced API is described using the OpenAPI Specification, a widely adopted standard for defining RESTful APIs in a structured, machine-readable format. This specification allows you to explore available endpoints, parameters, response types, and authentication requirements and is compatible with a wide range of developer tooling.

View the full API specification

Servers

The dmarced API is available at the following base URLs:

• Primary endpoint for live data

  Region: Europe (Frankfurt)

  Base URL: https://api.dmarced.eu

  Open API spec: https://api.dmarced.eu/openapi.json

• Sandbox for testing and pre-production

  Region: Europe (Frankfurt)

  Base URL: https://api.dmarced.testsite.lu

  Open API spec: https://api.dmarced.testsite.lu/openapi.json

Authentication

The dmarced API uses Bearer Token authentication to authorize requests on behalf of a team or user. All requests to protected endpoints must include an Authorization header with a valid token.

Each token is made up of two parts:

• A token ID, prefixed with pk_ (e.g., pk_zmh6pwusw1iw)
• A token secret, prefixed with sk_ (e.g., sk_nrAm8vY14wKiJsn9…)

These two parts are joined by a period (.) to form the full credentials string:

Authorization: Bearer pk_zmh6pwusw1iw.sk_nrAm8vY14wKiJsn9NS7s1ckryqT1UvozJ0Lq6IwvPvyb4pj2WI0qXpogvo54