€0.001 + VAT
Offer via API to your customers/employees the online Marriage Extract service in a secure, quick and easy way. Service managed by selected and recognised CAFs or Patronati, in full compliance with regulations.
Openapi provides access to all the main civil registry certificates such as Residence Certificate A.I.R.E., Family Status, Extract of Marriage.
The service is provided via API directly by a qualified professional and the timing, since it is carried out manually by operators, depends on the complexity of the file. Openapi guarantees that the entire process takes place in full compliance with current privacy regulations, with data minimisation and encryption logics.
The Marriage Extract contains all the information and annotations present in the Certificate, such as the personal data of the spouses, the date and place of the marriage (as transcribed in the civil status register), any separation, divorce, death. In addition to these, there is other information such as residence, citizenship, property regime (communion/separation of property). The marriage extract may be requested for any Italian city.
It is also possible to request a translation of the extract via the dedicated service and endpoint:
Openapi allows you to request the Marriage Extract quickly and easily. Thanks to the integration of our API, you can offer your customers an efficient and secure service to receive the certificate directly into your systems.
The request can be submitted directly by the declarant or through selected and recognised CAFs and Patronati (with delegation).
GET /visure
To request the Marriage Extract with Visengine, it is first necessary to identify the hash that uniquely identifies each document or file.
This is possible via the endpoint GET /visure which needs no parameters and will return the complete list of documents and files that can be requested via Visengine plus the respective hash.
https://visengine2.altravia.com/visure/
To verify the information, required documents, and the cost of the document, you need to make a request via the GET /visure/{hash_visura} endpoint and provide the hash of the previously obtained document.
GET /visure/{hash_visura}
https://visengine2.altravia.com/visure/38934ffe45179c4d5b88e2a6b849799a
GET /visure/{hash_visura}
The response will indicate all the information needed to complete the document request such as mandatory fields.
{
"data": {
"hash_visura": "90a405e6916d7245a6a6bb4a0ad5f9b0",
"json_struttura": {
"campi": {
"$0": {
"nome": "Nome",
"tipo": "testo",
"null": false,
"istruzioni": "Inserisci il nome del richiedente"
},
"$1": {
"nome": "Cognome",
"tipo": "testo",
"null": false,
"ordine": "1",
"istruzioni": "Inserisci il cognome del richiedente"
},
"$2": {
"nome": "Data di nascita",
"tipo": "data_iso8601",
"null": false,
"ordine": "3",
"istruzioni": "Inserire la data di nascita"
},
"$3": {
"nome": ""Stato di nascita",
"tipo": "testo",
"null": false,
"ordine": "3",
"istruzioni": "Inserisci lo stato di nascita"
},
"$4": {
"nome": ""Provincia del luogo del matrimonio",
"tipo": ""cod_provincia",
"null": false,
"ordine": "8",
"istruzioni": "Inserire la sigla della provincia del luogo del matrimonio"
},
"$5": {
"nome": "Comune del luogo del matrimonio",
"tipo": "cod_comune",
"null": false,
"ordine": "7",
"istruzioni": "Inserire il comune del luogo del matrimonio"
},
"$6": {
"nome": "Data del matrimonio",
"tipo": "data_iso8601",
"null": false,
"ordine": "6",
"istruzioni": "Inserire la data del matrimonio"
},
"$7": {
"nome": "Comune di nascita",
"tipo": "testo",
"null": false,
"ordine": "8",
"istruzioni": "Inserire il comune di nascita"
},
"$8": {
"nome": "Codice Fiscale",
"tipo": "codice_fiscale_persona_fisica",
"null": false,
"istruzioni": "Inserire il codice fiscale del richiedente"
},
"$9": {
"nome": "Delega Obbligatoria Firmata",
"tipo": "file",
"null": false,
"istruzioni": "Scarica, compila e allega la delega firmata"
}
},
"validazione": "($0 && $1 && $2 && $3 && $4 && $5 && $6 && $7) || ($0 && $1 && $2 && $3 && $4 && $5 && $6 && $7 && $8 && $9)",
"istruzioni": "",
"istruzioni_ricerca": ""
},
"nome_categoria": "Patronato",
"nome_visura": "Copia integrale atto di matrimonio",
"opzioni": [
{
"tipo": "apostilla",
"prezzo": 30,
"nome": "opzione_0",
},
{
"tipo": "urgenza",
"prezzo": 4,
"nome": "opzione_0",
},
{
"tipo": "assistenza_dedicata",
"prezzo": 10,
"nome": "opzione_1",
}
],
"prezzo_ricerca": 0,
"prezzo_visura": 30.5,
"ricerca": false,
"sincrona": false,
"fornitori": [
]
},
"success": true,
"message": "",
"error": null
}
In validation, the data(s) required to successfully complete the request are indicated.
The data required for the request are:
Additional documents useful for submitting the Marriage Extract will be requested by the CAF or Patronato, which will handle the file in accordance with privacy regulations.
POST /richiesta
{
"hash_visura": "38934ffe45179c4d5b88e2a6b849799a",
"json_visura": {
"$0": "Nome",
"$1": "Cognome",
"$2": "Email",
"$3": "Cellulare",
"$4": "Codice Fiscale",
"$5": "Copia Documento d'identità",
"$6": "Copia Codice Fiscale",
"$7": "Copia Mandato di Assistenza e Rappresentanza"
}
}
POST /richiesta
The response returns several pieces of information including the status, if callback is set, and the request ID that we will need later to download the document.
{ "data":
{
"_id": "5fec14002548c9ae115758500c8981ee",
"state": 1,
"hash_visura": "90a405e6916d7245a6a6bb4a0ad5f9b0",
"nome": "Estratto di matrimonio",
"ricerca": false,
"id_ricerca": null,
"prezzo_visura": 26.90,
"prezzo_ricerca": 0,
"indice_ricerca": null,
"stato_richiesta": "In erogazione",
"email_target": null,
"allegati": [],
"timestamp_creation": 1596467662,
"timestamp_last_update": 1596467663,
"timestamp_stati": {
"in_ricerca": 1596467663,
"in_erogazione": 1596467663
},
"callback_data": false,
"opzioni": null,
"owner": "[email protected]",
"sincrona": false,
"ricerche": [],
"esito": {
"codice": "0",
"info": "OK"
}
Once the status of the request is in 'evaso' (=‘processed’), it is possible to download the document via the GET /documento/{_id} method.
GET /documento/{_id}
This is an example of a request using the previously obtained ID
https://visengine2.altravia.com/visure/documento/5f2829ce065afc21cc60ad0e
GET /documento/{_id}
The response will contain the name, size and file.
{
data{
"nome":"5f22f5b5065afc21cc60a27a.zip",
"dimensione"10206",
"file":"++6+47433njVP9ZcX1XNtWUsKrTya9FGhwiXgdp5j5OPh0FpaKWVpjP8CUEjFjYzYwYTI3YS5wZGZVVAUAAwhDKF91eAsAAQQhAAAABCEAAABQSwUGAAAAAAEAAQBiAAAAZicAAAAA"
},
"success": true,
"message": "",
"error": null
}
By integrating the Openapi API, companies can offer their customers an efficient and compliant service for the presentation of the Extract of Marriage, taking advantage of the professional management of recognised CAFs and Patronati.
Do you need help?
Haven't found the answer you're looking for?
Fill in all the details, we will get back to you as soon as possible!
The service allows you to integrate the Marriage Extract request via API, which is the official document that certifies a marital union, reporting the information related to the ceremony and recorded in the civil status register.
On Openapi, you can also request the marriage extract translated into English, French, Spanish, or other languages.
The service is fast, easy, and secure, and is managed by selected and recognized CAFs or Patronati, in compliance with regulations.
The service is part of Docuengine, the API for requesting over 128 official documents, benefits, and reports, with data coming from certified sources.
The main categories of documents available via Docuengine are as follows:
The services currently available on Openapi include:
The service is designed for companies that wish to easily integrate the Marriage Certificate Extract request via API, offering their clients and employees a fast and high-quality experience.
The process is handled by CAF and Patronati, managed by authorized and specialized personnel, ensuring full compliance with privacy regulations.
Openapi manages the entire request process via API in full compliance with the current privacy regulations, with data minimization and encryption measures.
For more information, you can consult the Privacy documentation on our website.
The produced documents are deleted from Openapi's systems based on the timelines visible in the Redemption Period (the deadline after which the document is deleted from our servers) within the privacy documentation. If necessary, the client can contact the authorized Professional who provided the service, who is required to keep a copy in accordance with regulations.
The certificate is issued in digital format within approximately 20 business days. In the case of a request for an apostille for foreign use and/or a legalized translation, delivery times may exceed the indicated 20 days.
The cost for each request is €30.50 for the document in Italian, €105 for the document translated into English, French, and Spanish, and €139 for the document translated into other languages.