Certified Domains

The Domains endpoint allows you to activate and manage certified domains for certified email via API. This service is designed for platforms that want to offer PEC mailboxes with a custom domain, fully automating the configuration and management process.

By integrating the Domains API, you can create certified domains, associate them with your services, and manage multiple domains for different customers in a scalable way, without manual intervention.

Certified PEC domains

A certified domain allows you to create custom PEC mailboxes (e.g., [email protected]), providing greater control, branding, and flexibility compared to standard domains.

Once the certification process is completed, the domain can be used to create new custom PEC mailboxes, enabling you to offer a fully branded service under your full control.

Before requesting domain certification, some technical configurations must be completed to prove ownership or control of the domain. In particular, the domain must be correctly configured at DNS level and be consistent with the registration data (WHOIS or equivalent configurations).

These steps must be completed in advance by the user, as they are a fundamental requirement to start the certification process and ensure proper domain activation.

The service uses an asynchronous process: once the activation request is submitted, the domain is configured and made available within 24 hours.

The service allows you to:

This endpoint is particularly useful for software houses, system integrators, and platforms that want to offer custom PEC services to their customers.

Certified domain activation

The POST/domini endpoint allows you to activate a certified domain.

REQUEST EXAMPLE

POST/domini

This is an example request to activate a certified domain:

POST https://pec.openapi.it/domini

The request body must include the domain and owner details:

This is an example payload:

{
  "dominio": "tuodominio.it",
  "ragione_sociale": "Azienda Srl",
  "partita_iva": "12345678901",
  "email": "[email protected]",
  "telefono": "0212345678",
  "indirizzo": "Via Roma 1",
  "comune": "Milano",
  "cap": "20100",
  "nazione": "IT"
}

Once the request is sent, the domain is processed and activated within 24 hours.

RESPONSE EXAMPLE

POST/domini

The response contains information about the domain and its status:

{
  "data": {
    "dominio": "tuodominio.it",
    "stato": "in_attivazione",
    "timestamp": {
      "richiesta": 1710000000
    },
    "id": "abc123xyz"
  },
  "success": true,
  "message": "",
  "error": null
}

Certified domain status check

You can check the domain status at any time using the GET/domini/{id} endpoint.

REQUEST EXAMPLE

GET/domini/{id}

The request to check the domain status with id abc123xyz will be:

GET https://pec.openapi.it/domini/abc123xyz

RESPONSE EXAMPLE

GET/domini/{id}

This is an example response:

{
  "data": {
    "dominio": "tuodominio.it",
    "stato": "attivo",
    "timestamp": {
      "attivazione": 1710003600
    },
    "id": "abc123xyz"
  },
  "success": true,
  "message": "",
  "error": null
}

Once active, the domain can be used to create and manage custom PEC mailboxes.

Who it is for

The Certified Domains service is designed for organizations that want to offer PEC mailboxes with a custom domain or manage certified domains in a scalable and automated way.

It is particularly suitable for software houses and system integrators developing management platforms or SaaS solutions, where domains need to be activated and managed for multiple customers in a centralized way without manual intervention.

At the same time, it is a strategic tool for PEC service providers and resellers, who can offer their customers certified mailboxes with a custom domain, increasing service value and branding.

The service is also suitable for structured companies and organizations that want to manage their certified domains internally, maintaining full control over PEC communications and related processes.