€23.40 + VAT
Integrate via API and online the Marriage Certificate service quickly, securely and easily. The service is managed by selected and recognised CAFs or Patronati, in full compliance with regulations.
Openapi allows access to all major Civil Status Certificates, such as the Residence Certificate, Family Status Certificate, and Marriage Certificate. Civil status certificates are official documents that certify and attest to a person's civil status, residence, and other data related to the individual registered with the municipality of residence.
The service is provided via API directly by a qualified professional, and the processing times, since they involve manual work by operators, depend on the complexity of the request. Openapi ensures that the entire process complies fully with current privacy regulations, following data minimization and encryption principles.
The Marriage Certificate contains and certifies information related to the marriage, such as the spouses' personal details, the date and place of marriage as recorded in the civil registry. Additional annotations may also be present, such as separations, divorces, or death. The Marriage Certificate can be requested for any Italian city.
Openapi allows you to request the Marriage Certificate quickly and easily. Through the integration of our APIs, you can offer your customers an efficient and secure service to receive the certificate directly within your systems.
The request can be submitted directly by the declarant or through selected and recognized CAFs and Patronati (with authorization).
GET /documents
To request the Marriage Certificate with Docuengine, you must first verify all parameters to correctly complete the request.
https://docuengine.openapi.com/documents
This is possible via the GET /documents endpoint, which does not require parameters and will return the complete list of documents and practices available through Docuengine along with their respective parameters and costs.
GET /documents
The response will indicate all the necessary information to complete the request for documents available via the Docuengine API. In our case, we will focus only on the data for the Marriage Certificate.
{
"data": [
{
"requestStructure": {
"fields": {
"field0": {
"name": "firstSpouseName",
"nameIT": "nome primo coniuge",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il nome del primo coniuge"
},
"field1": {
"name": "firstSpouseSurname",
"nameIT": "cognome primo coniuge",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il cognome del primo coniuge"
},
"field2": {
"name": "firstSpouseBirthDate",
"nameIT": "data nascita primo coniuge",
"type": "date",
"required": true,
"options": null,
"help": "Inserire la data di nascita del primo coniuge"
},
"field3": {
"name": "firstSpouseBirthTown",
"nameIT": "comune nascita primo coniuge",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il comune di nascita del primo coniuge"
},
"field4": {
"name": "secondSpouseName",
"nameIT": "nome secondo coniuge",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il nome del secondo coniuge"
},
"field5": {
"name": "secondSpouseSurname",
"nameIT": "cognome secondo coniuge",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il cognome del secondo coniuge"
},
"field6": {
"name": "secondSpouseBirthDate",
"nameIT": "data nascita secondo coniuge",
"type": "date",
"required": true,
"options": null,
"help": "Inserire la data di nascita del secondo coniuge"
},
"field7": {
"name": "secondSpouseBirthTown",
"nameIT": "comune nascita secondo coniuge",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il comune di nascita del secondo coniuge"
},
"field8": {
"name": "celebrationTown",
"nameIT": "comune celebrazione matrimonio",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il comune di celebrazione del matrimonio"
},
"field9": {
"name": "registrationTown",
"nameIT": "comune trascrizione matrimonio",
"type": "string",
"required": false,
"options": null,
"help": "Inserire il comune di trascrizione del matrimonio (solo in caso di matrimonio celebrato in altro comune ad esempio all'estero e trascritto successivamente in italia)"
},
"field10": {
"name": "celebrationDate",
"nameIT": "date celebrazione matrimonio",
"type": "date",
"required": true,
"options": null,
"help": "Inserire la data di celebrazione del matrimonio"
},
"field11": {
"name": "spouseDelegation",
"nameIT": "delega coniuge",
"type": "file",
"required": true,
"options": null,
"help": "Caricare la delega di uno dei due coniugi"
},
"field12": {
"name": "spouseDocument",
"nameIT": "documento identita' coniuge",
"type": "file",
"required": true,
"options": null,
"help": "Caricare il documento d'identita' di uno dei due coniugi"
},
"field13": {
"name": "notes",
"nameIT": "note",
"type": "string",
"required": false,
"options": null,
"help": "Note aggiuntive"
}
},
"validation": "",
"help": null,
"searchHelp": null
},
"category": "Patronato",
"name": "Certificato Di Matrimonio",
"options": [
{
"name": "urgenza",
"price":4
},
{
"name": "assistenza_dedicata",
"price": 10
}
],
"hasSearch": false,
"isSync": false,
"id": "67d066362cbb7e30d3d93e27",
"searchPrice": 0,
"documentPrice": 23.4,
"totalPrice": 23.4
}
],
"success": true,
"message": "",
"error": null
}
The required fields for validation are indicated to ensure the request is completed successfully.
The required data for the request includes:
Any additional documents required will be requested by the CAF or Patronato handling the application in compliance with privacy regulations.
POST /requests
To request the Certificate, you need to submit a request to the POST /requests endpoint, providing the required details: first and last name, date and place of birth of both spouses, place and date of marriage, as well as authorization and identity document.
POST /requests
{
"documentId": "67d066362cbb7e30d3d93e27"
"search": {
"field0": "first spouse's first name",
"field1": "first spouse's last name",
"field2": "first spouse's date of birth",
"field3": "first spouse's birth municipality",
"field4": "second spouse's first name",
"field5": "second spouse's last name",
"field6": "second spouse's date of birth",
"field7": "second spouse's birth municipality",
"field8": "marriage celebration municipality",
"field9": "marriage transcription municipality",
"field10": "marriage celebration date",
"field11": "spouse authorization",
"field12": "spouse identity document",
"field13": "notes"
}
}
POST /requests
The response returns various details, including status, callback settings (if any), and the request ID, which will be required later to download the document.
{
"data" {
"documentId": "67d066362cbb7e30d3d93e27"
"search": {
"field0": "nome primo coniuge",
"field1": "cognome primo coniuge",
"field2": "data nascita primo coniuge",
"field3": "comune nascita primo coniuge",
"field4": "nome secondo coniuge",
"field5": "cognome secondo coniuge",
"field6": "data nascita secondo coniuge",
"field7": "comune nascita secondo coniuge",
"field8": "comune celebrazione matrimonio",
"field9": "comune trascrizione matrimonio",
"field10": "date celebrazione matrimonio",
"field11": "delega coniuge",
"field12": "documento identita' coniuge",
"field13": "note"
},
"data": {}
},
"timestamps": {
"creation": 1724416377,
"WAIT": 1724416377,
"lastUpdate": 1724416393
},
"state": "WAIT",
"readableSearch": {},
"optionsPrice": 0,
"selectedOptions": null,
"notifyEmail": null,
"name": "Certificato di Matrimonio",
"hasSearch": false,
"searchPrice": 0,
"documentPrice": 23.4,
"totalPrice": 23.4,
"documents": null,
"resultId": null,
"results": null,
"id": "67d066362cbb7e30d3d93e27"
},
"success": true,
"message": "",
"error": null
}
PATCH /requests/{_id}
By default, if the "STATE" field is not set, the transaction is considered immediately closed, and your request will be processed and fulfilled. However, if it is set, the transaction is initiated but remains open, allowing you to update the request through the PATCH /requests/{_id} endpoint.
PATCH /requests/{_id}
This endpoint allows updating specific fields of the request and completing its process: closing it if the status is "NEW" or selecting a result generated from the search if the document has the 'hasSearch' parameter set to true.
{
"data" {
"documentId": "67d066362cbb7e30d3d93e27"
"search": {
"field0": "nome primo coniuge",
"field1": "cognome primo coniuge",
"field2": "data nascita primo coniuge",
"field3": "comune nascita primo coniuge",
"field4": "nome secondo coniuge",
"field5": "cognome secondo coniuge",
"field6": "data nascita secondo coniuge",
"field7": "comune nascita secondo coniuge",
"field8": "comune celebrazione matrimonio",
"field9": "comune trascrizione matrimonio",
"field10": "date celebrazione matrimonio",
"field11": "delega coniuge",
"field12": "documento identita' coniuge",
"field13": "note"
},
"data": {}
},
"timestamps": {
"creation": 1724416377,
"WAIT": 1724416377,
"lastUpdate": 1724416393
},
"state": "WAIT",
"readableSearch": {},
"optionsPrice": 0,
"selectedOptions": null,
"notifyEmail": null,
"name": "Certificato di Matrimonio",
"hasSearch": false,
"searchPrice": 0,
"documentPrice": 23.4,
"totalPrice": 23.4,
"documents": null,
"resultId": null,
"results": null,
"id": "67d066362cbb7e30d3d93e27"
},
"success": true,
"message": "",
"error": null
}
When the request is in "fulfilled" status, the document can be downloaded in PDF format. The endpoint that allows downloading the documents generated from the request is: GET/requests/{id}/documents
The response will indicate the file name, size, and the download URL.
{
data{
"fileName":"5f22f5b5065afc21cc60a27a_0.pdf",
"mimeType"application/pdf",
"fileSize":"34144",
"md5":"application/pdf",
"urlExpire":"1724505599",
"downloadUrl":"https://storage.googleapis.com/test-docuengine-openapi-com/documents/5f22f5b5065afc21cc60a27a_0.pdf",
},
"success": true,
"message": "",
"error": null
}
The PDF file is provided in base64-encoded format.
It is also possible to request the Marriage Certificate with apostille and translation via the dedicated endpoints of the Visengine API:
By integrating Openapi's APIs, companies can offer their customers an efficient and compliant service for requesting the Certificate of Residency, leveraging the professional management of recognized CAF 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 the integration via API of the request for the Marriage Certificate, which certifies the information related to the marriage ceremony (personal details of the spouses, date, and place) recorded in the civil status registry.
On Openapi, it is also possible to request the marriage certificate 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 request for Marriage Certificate via API, providing their clients and employees with a quick and high-quality experience.
The application is entrusted to CAF and Patronati managed by authorized and specialized personnel, and everything is done in 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 in approximately 15 working days.
In case of a request for an apostille for foreign use and/or a legalized translation, the delivery times may exceed the indicated 20 days.
The cost for a single request is: