Unemployment allowance (NASpI) - Italy
€1.00 + VAT
Get your NASpI unemployment benefit via API and online quickly, safely and easily, at a cost of 1€. Service managed by selected and recognised CAFs or Patronati, in full compliance with regulations.
Openapi allows access via API to all the main Patronato and CAF services such as NASpI, AIRE Residence Certificate, Marriage Certificate and Marriage Extract.
The service is provided via API directly by a qualified professional and the timing, since the processing is manually carried out by operators, depends on the complexity of the case. Openapi ensures that the entire process takes place in full compliance with current privacy regulations, with data minimization and encryption logic.
NASpI Unemployment Benefit
With Openapi it is possible to easily integrate the NASpI application and other services related to unemployment, at the cost of €1.
These are the types of NASpI available via the DocuEngine API:
- NASpI
- NASpI COM
- Anticipated NASpI
The cost of NASpI refers to the IT activity. The document request itself is free.
The application for the unemployment benefit can be submitted directly by the applicant or through selected and recognized CAF and Patronati (with delegation).
NASPI REQUEST
To request NASpI with Docuengine, first you need to access the mandatory parameters to correctly complete the request.
REQUEST EXAMPLE
GET /documents
https://docuengine.openapi.com/documents
This is possible through the GET /documents endpoint which does not require parameters and will return the complete list of documents and procedures available via Docuengine.
RESPONSE EXAMPLE
GET /documents
The response will indicate not only the list but all the information needed to complete the document request and the respective costs available via the Docuengine API. In our case, we are only interested in NASpI data:
{
"data": [
{
"requestStructure": {
"fields": {
"field0": {
"name": "name",
"nameIT": "nome",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il nome del primo richiedente"
},
"field1": {
"name": "surname",
"nameIT": "cognome",
"type": "string",
"required": true,
"options": null,
"help": "Inserire il cognome del primo richiedente"
},
"field2": {
"name": "email",
"nameIT": "email",
"type": "email",
"required": true,
"options": null,
"help": "Inserire un’email del richiedente"
},
"field3": {
"name": "phone",
"nameIT": "telefono",
"type": "string",
"required": true,
"options": null,
"help": "Inserire un contatto telefonico del richiedente"
},
"field4": {
"name": "taxCode",
"nameIT": "codice fiscale",
"type": "taxCode",
"required": false,
"options": null,
"help": "Inserire il codice fiscale del richiedente"
},
"field5": {
"name": "document",
"nameIT": "documento identita’",
"type": "file",
"required": true,
"options": null,
"help": "Caricare una copia fronte retro del documento d'identita' del richiedente"
},
"field6": {
"name": "taxCodeDocument",
"nameIT": "documento codice fiscale",
"type": "file",
"required": true,
"options": null,
"help": "Caricare una copia fronte retro del codice fiscale del richiedente"
},
"field7": {
"name": "delegationFile",
"nameIT": "delega",
"type": "file",
"required": false,
"options": null,
"help": "Caricare una copia del mandato di assistenza e rappresentanza del Caf assegnato"
},
"validation": "(field0 && field1 && field2 && field3 && field4 && field5 && field6) || (field0 && field1 && field2 && field3 && field4 && field5 && field6 && field7)",
"help": null,
"searchHelp": null
},
"category": "Patronato",
"name": "NASPI",
"options": [
{
"name": "urgenza",
"price":4
},
{
"name": "assistenza_dedicata",
"price": 10
}
],
"hasSearch": false,
"isSync": false,
"id": "67dc3d052cbb7e30d3d93e88",
"searchPrice": 0,
"documentPrice": 1,
"totalPrice": 1
}
],
"success": true,
"message": "",
"error": null
}The validation shows the required data to successfully complete the request.
The necessary data for the request are:
- first name
- surname
- phone number
- tax code number
- copy of ID document
- copy of tax code
- copy of the assistance and representation mandate of the assigned CAF
Any additional documents needed will be requested by the CAF or Patronato handling the case, in accordance with privacy regulations.
Request the document
To request NASpI, you must make a request to the POST /requests endpoint, providing the previously indicated data.
REQUEST EXAMPLE
POST /requests
{
"documentId": "67dc3d052cbb7e30d3d93e88"
"search": {
"field0": "name",
"field1": "surname",
"field2": "email",
"field3": "phone",
"field4": "taxCode",
"field5": "document",
"field6": "taxCodeDocument",
"field7": "delegationFile",
}
}RESPONSE EXAMPLE
POST /requests
The response returns various information including the status, whether the callback is set, and the request ID that will be needed later to download the document.
{
"data" {
"documentId": "67dc3d052cbb7e30d3d93e88"
"search": {
"field0": "name",
"field1": "surname",
"field2": "email",
"field3": "phone",
"field4": "taxCode",
"field5": "document",
"field6": "taxCodeDocument",
"field7": "delegationFile",
},
"data": {}
},
"timestamps": {
"creation": 1724416377,
"WAIT": 1724416377,
"lastUpdate": 1724416393
},
"state": "WAIT",
"readableSearch": {},
"optionsPrice": 0,
"selectedOptions": null,
"notifyEmail": null,
"name": "NASPI",
"hasSearch": false,
"searchPrice": 0,
"documentPrice": 1,
"totalPrice": 1,
"documents": null,
"resultId": null,
"results": null,
"id": "67d066362cbb7e30d3d93e27"
},
"success": true,
"message": "",
"error": null
}Update the request
By default, if the "STATE" field is not set, the transaction is considered immediately closed and your request will be managed and fulfilled. If instead it is set, the transaction is started but remains open, so you can proceed to update the request through the endpoint PATCH /requests/{_id}.
REQUEST EXAMPLE
PATCH /requests/{_id}
This endpoint allows you to update certain fields of the request and complete its process: closing it, if the state is "NEW", or selecting a result generated by the search, in case the document has the 'hasSearch' parameter set to true.
{
"data" {
"documentId": "67d066362cbb7e30d3d93e27"
"search": {
"field0": "name",
"field1": "surname",
"field2": "email",
"field3": "phone",
"field4": "taxCode",
"field5": "document",
"field6": "taxCodeDocument",
"field7": "delegationFile",
}
"data": {}
},
"timestamps": {
"creation": 1724416377,
"WAIT": 1724416377,
"lastUpdate": 1724416393
},
"state": "WAIT",
"readableSearch": {},
"optionsPrice": 0,
"selectedOptions": null,
"notifyEmail": null,
"name": "NASPI",
"hasSearch": false,
"searchPrice": 0,
"documentPrice": 1,
"totalPrice": 1,
"documents": null,
"resultId": null,
"results": null,
"id": "67d066362cbb7e30d3d93e27"
},
"success": true,
"message": "",
"error": null
}Download the document
GET /requests/{id}/documents
When the request is in "DONE" status, it is possible to download the document in PDF format.
The response will indicate the file name, size, and the download URL of 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
}By integrating Openapi's APIs, companies can offer their clients an efficient and compliant service for submitting the NASpI application, 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 for the integration of the NASpI (New Social Insurance for Employment) request via API, which is the monthly unemployment benefit that replaces the previous ASpI and MiniASpI and is granted upon the request of individuals who have involuntarily lost their jobs.
With Openapi, it is possible to request in particular:
- NASpI
- NASpI COM
- Early NASpI
The service is fast, easy, and secure, and is managed by selected and recognized CAF (Tax Assistance Centers) or Patronati (Labor Unions), 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:
- Chamber of Commerce documents
- Cadastral documents
- Real Estate Services
- Patronato services
The services currently available on Openapi include:
- Unemployment allowance Unemployment allowance NASpI, NASpI COM, and Early NASpI
- ISEE, ISEE Adjustment, Current ISEE, Residential Socio-Health ISEE
- Single and Joint 730 forms
- Single Allowance Application
- Pension Calculation and Forecast and Contribution Extract
- Survivor's Pension and Old Age Pension
- Financial Package
- CUD for Pensioners
- Restoration of Contributions
- OBIS-M
- Resignation and Revocation of Voluntary Electronic Resignation
- Request and Renewal of Disability Allowance
- Maternity Benefits
- Military Service Buyback
- Compensation for Extraordinary Leave (Law 104) and Parental Leave
The service is designed for companies that wish to easily integrate the request for unemployment benefits via API, providing their clients and employees with a quick and high-quality experience.
The NASpI 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 service is provided within 3 working days from the delivery of the complete documentation.
The cost per request is €12.70.
Carbon free energy for Our Cloud 
Low CO2
© 2024 Openapi SpA, a single-member company, under the direction and control of Open Holding Srl.
Viale Filippo Tommaso Marinetti 221 - 00143 Rome - Business Register: 1378273, Share Capital: €50,000.00, VAT Number: IT12485671007, Recipient Code: 'USAL8PV' - Certified Email: 
Openapi is certified in: Quality System **UNI EN ISO 9001:2015** - Data Quality **ISO 25012:2014** - Security Management **ISO/IEC 27001:2022** - Geneder Equality According UNI PdR 125:2022
All prices are net of any VAT, stamp duty, registration fees, or other taxes that may be due. All logos listed on the portal are copyrighted and owned by their respective owners.
