€23.40 + 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 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 through APIs directly from an authorized professional, and the processing time, being manual work by operators, depends on the complexity of the request. Openapi guarantees that the entire process is carried out in full compliance with the current privacy regulations, with data minimization and encryption practices.
The Marriage Extract contains all the information and annotations found in the Certificate, such as the spouses' personal details, the date and place of marriage (as recorded in the civil registry), possible separation, divorce, or death. In addition to these, other information is included, such as residence, nationality, and marital property regime (community/separation of assets). The Marriage Extract can be requested for any Italian city.
Openapi allows you to request the Marriage Extract in a simple and fast way. Thanks to the integration of our APIs, you can offer your clients an efficient and secure service to request and receive the document directly into your systems.
The request can be made directly by the declarant or through selected and recognized CAFs and Patronages (with authorization).
GET /documents
To request the Marriage Extract with Docuengine, it is necessary to verify all the parameters to correctly complete the request.
https://docuengine.openapi.com/documents
This is possible through the endpoint GET /documents which requires no parameters and will return the full list of documents and processes that can be requested via Docuengine along with the respective parameters and costs.
GET /documents
The response will provide all the necessary information to complete the request for the available documents through the Docuengine API. In our case, we will only be interested in the data for the Extract of Mariage:
{
"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 mascita 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": "Estratto Di Matrimonio",
"options": [
{
"name": "urgenza",
"price":4
},
{
"name": "assistenza_dedicata",
"price": 10
}
],
"hasSearch": false,
"isSync": false,
"id": "66ffea9fa2b0bc1d3104fa54",
"searchPrice": 0,
"documentPrice": 23.4,
"totalPrice": 23.4
}
],
"success": true,
"message": "",
"error": null
}
The validation process indicates the mandatory data required to successfully complete the request.
The necessary data for the request are:
Additional documents required will be requested by the CAF or Patronage managing the process, in compliance with privacy regulations.
POST /requests
POST /requests
{
"documentId": "66ffea9fa2b0bc1d3104fa54"
"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 mascita secondo coniuge",
"field8": "comune celebrazione matrimonio",
"field9": "comune trascrizione matrimonio",
"field10": "date celebrazione matrimonio",
"field11": "delega coniuge",
"field12": "documento identita' coniuge",
"field13": "note"
}
}
POST /requests
The response will return various information including the status, if the callback is set, and the request ID that will be needed later to download the document.
{
"data" {
"documentId": "66ffea9fa2b0bc1d3104fa54"
"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 mascita 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": "Estratto di Matrimonio",
"hasSearch": false,
"searchPrice": 0,
"documentPrice": 23.4,
"totalPrice": 23.4,
"documents": null,
"resultId": null,
"results": null,
"id": "66ffea9fa2b0bc1d3104fa54"
},
"success": true,
"message": "",
"error": null
}
PATCH /requests/{_id}
By default, if the "STATE" field is not filled, the transaction is immediately considered closed and your request will be processed. If set, the transaction is started but remains open, and you can proceed to update the request using the endpoint PATCH /requests/{_id}.
PATCH /requests/{_id}
This endpoint allows updating specific fields of the request and completing the 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": "66ffea9fa2b0bc1d3104fa54"
"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 mascita 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": "Estratto di Matrimonio",
"hasSearch": false,
"searchPrice": 0,
"documentPrice": 23.4,
"totalPrice": 23.4,
"documents": null,
"resultId": null,
"results": null,
"id": "66ffea9fa2b0bc1d3104fa54"
},
"success": true,
"message": "",
"error": null
}
Once the request is in "completed" status, you can download the document in PDF format. The endpoint to download documents generated by the request is: GET/requests/{id}/documents
The response will indicate the file name, size, and the URL for downloading the file.
{
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.
You can also request the Marriage Extract with apostille and translation through the dedicated endpoints of the Visengine API:
By integrating Openapi's APIs, businesses can offer their clients an efficient and compliant service for requesting the Marriage Extract, utilizing the professional management of recognized CAFs and Patronages.
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 15 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 €23.40 for the document in Italian, €105 for the document translated into English, French, and Spanish, and €139 for the document translated into other languages.