Through a dedicated endpoint, it is possible to enable a monitoring service on the Company services, in order to receive notifications in case of updates related to the company data of interest.
By setting a callback, the system will automatically send a notification whenever changes are detected. The frequency of checks varies depending on the selected service; below are some examples:
- Every 7 days for the services: IT-aml, IT-marketing, IT-stakeholders, IT-full, IT-closed, IT-vatgroup, IT-sdicode
- Every 30 days for the services: IT-Start, IT-Advanced, IT-shareholders, IT-address, IT-pec, IT-name, IT-ubo, FR-Start, FR-Advanced, DE-Start, DE-Advanced, ES-Start, ES-Advanced, PT-Start, PT-Advanced, GB-start, GB-Advanced, BE-Start, BE-Advanced, AT-Start, AT-Advanced, CH-Start, CH-Advanced, PL-Start, PL-Advanced, WW-Start, WW-Advanced, WW-Top
The monitoring service lasts for 12 months.
- If autorenew = false, the service will automatically expire at the end of the period.
- If autorenew = true, the monitoring service will be automatically renewed, provided that sufficient credit is available.
An ideal solution to integrate continuous checks, onboarding processes, anti-money laundering (AML) and compliance directly into your application workflows.
REQUEST EXAMPLE
POST /monitor
This endpoint allows you to create a new monitoring request for a company. If a callback has been set, you will receive a notification at the first check and whenever one or more fields set for monitoring change.
{
"code": "12485671007",
"dataset": "IT-advanced",
"monitoredFields": [
"activityStatus"
],
"callback": {
"url": "https://webhook.site/f24cec85-22e3-4f7c-8ec0-227b240daa42"
}
}For all datasets other than IT and FR, if at the time of the request no company is found with the code provided in the payload, in addition to the 404 error, a search fee will also be charged at the cost of the selected dataset.
RESPONSE EXAMPLE
POST /monitor
{
"data": {
"code": "12485671007",
"dataset": "IT-advanced",
"monitoredFields": [
"pec"
],
"callback": {
"method": "JSON",
"url": "https://webhook.site/28a4dddf-eca1-47f2-88d8-94878995e4d8",
"user_id": "",
"username": "",
"field": "data",
"headers": {},
"data": {},
"retry": 0,
"scope": null,
"domain": null,
"custom": null
},
"owner": "[email protected]",
"createdOn": "2026-02-03",
"companyId": "60d1bfc731177b0a092cdfc1",
"vatCode": "12485671007",
"taxCode": "12485671007",
"companyName": "OPENAPI S.P.A.",
"updatedFields": null,
"latestDataset": null,
"previousDataset": null,
"checkedOn": null,
"nextOn": "2026-03-05",
"expiresOn": "2027-02-03",
"autorenew": true,
"id": "6981e3571a222556460af532"
},
"success": true,
"message": "",
"error": null
}SPECIFIC REQUEST EXAMPLE
GET/monitor/{id}
Endpoint that returns the request identified by the identifier passed in the path.
In a test environment, it is possible to make a synchronous call that simulates the system check on the company fields you wish to monitor. Simply perform a GET on this URL: https://test.company.openapi.com/monitor/{id}?callback
{
"data": {
"code": "12485671007",
"dataset": "IT-advanced",
"monitoredFields": [
"pec"
],
"callback": {
"method": "JSON",
"url": "https://webhook.site/28a4dddf-eca1-47f2-88d8-94878995e4d8",
"user_id": "",
"username": "",
"field": "data",
"headers": {},
"data": {},
"retry": 0,
"scope": null,
"domain": null,
"custom": null
},
"owner": "[email protected]",
"createdOn": "2026-02-03",
"companyId": "60d1bfc731177b0a092cdfc1",
"vatCode": "12485671007",
"taxCode": "12485671007",
"companyName": "OPENAPI S.P.A.",
"updatedFields": {
"pec": "[email protected]"
},
"latestDataset": {
"taxCode": "12485671007",
"vatCode": "12485671007",
"companyName": "OPENAPI S.P.A.",
"address": {
"registeredOffice": {
"toponym": "VIALE",
"street": "F TOMMASO MARINETTI",
"streetNumber": "221",
"streetName": "VIALE F TOMMASO MARINETTI 221",
"town": "ROMA",
"hamlet": null,
"province": "RM",
"zipCode": "00143",
"gps": {
"coordinates": [
12.47843,
41.8071
]
},
"region": {
"code": "12",
"description": "LAZIO"
},
"townCode": "H501"
}
},
"activityStatus": "ATTIVA",
"reaCode": "1378273",
"cciaa": "RM",
"atecoClassification": {
"ateco": {
"code": "6201",
"description": "Produzione di software non connesso all'edizione"
}
},
"detailedLegalForm": {
"code": "SP",
"description": "SOCIETÀ PER AZIONI"
},
"startDate": "2013-10-20",
"registrationDate": "2013-07-19",
"endDate": null,
"pec": "[email protected]",
"taxCodeCeased": false,
"taxCodeCeasedTimestamp": 1708699396,
"vatGroup": {
"vatGroupParticipation": false,
"isVatGroupLeader": false,
"registryOk": true
},
"sdiCode": "USAL8PV",
"sdiCodeTimestamp": 1709049141,
"creationTimestamp": 1624358855,
"lastUpdateTimestamp": 1708705000,
"balanceSheets": {
"last": {
"year": 2022,
"employees": 14,
"balanceSheetDate": "2022-12-31",
"turnover": 4043407,
"netWorth": 166491,
"shareCapital": 50000,
"totalStaffCost": 604997,
"totalAssets": 1483126,
"avgGrossSalary": 43214
},
"all": [
{
"year": 2024,
"employees": 15,
"balanceSheetDate": null,
"turnover": null,
"netWorth": null,
"shareCapital": 50000
},
{
"year": 2023,
"employees": 15,
"balanceSheetDate": null,
"turnover": null,
"netWorth": null,
"shareCapital": 50000
},
{
"year": 2022,
"employees": 14,
"balanceSheetDate": "2022-12-31",
"turnover": 4043407,
"netWorth": 166491,
"shareCapital": 50000,
"totalStaffCost": 604997,
"totalAssets": 1483126,
"avgGrossSalary": 43214
},
{
"year": 2021,
"employees": 15,
"balanceSheetDate": "2021-12-31",
"turnover": 4432761,
"netWorth": 469366,
"shareCapital": 50000
},
{
"year": 2020,
"employees": 14,
"balanceSheetDate": "2020-12-31",
"turnover": 4192138,
"netWorth": 170234,
"shareCapital": 10000
},
{
"year": 2019,
"employees": 14,
"balanceSheetDate": "2019-12-31",
"turnover": 1799587,
"netWorth": 111309,
"shareCapital": 10000
},
{
"year": 2018,
"employees": null,
"balanceSheetDate": "2018-12-31",
"turnover": 1325358,
"netWorth": 826,
"shareCapital": null
},
{
"year": 2017,
"employees": null,
"balanceSheetDate": "2017-12-31",
"turnover": 1120176,
"netWorth": 2928,
"shareCapital": null
}
]
},
"shareHolders": [
{
"companyName": "OPEN HOLDING S.R.L.",
"name": null,
"surname": null,
"taxCode": "16935371001",
"percentShare": 100
}
],
"id": "60d1bfc731177b0a092cdfc1"
},
"previousDataset": null,
"checkedOn": "2026-02-03",
"nextOn": "2026-03-05",
"expiresOn": "2027-02-03",
"autorenew": true,
"id": "6981e3571a222556460af532"
},
"success": true,
"message": "",
"error": null
}DELETE REQUEST
Through the endpoint DELETE/monitor/{id} it is possible to delete a company monitoring request
{
"data": [],
"success": true,
"message": "1 deleted monitor",
"error": null
}
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 Company Monitoring Service allows you to keep track of relevant company information over time. Through a dedicated endpoint, the system periodically checks for any data updates and automatically notifies the customer in case of changes.
It is possible to configure a callback URL. When the system detects a change compared to the previously available data, it sends an automatic notification to the configured callback, without the need to perform manual checks or periodic queries.
The frequency of checks depends on the activated monitoring service. Currently, two time intervals are:
Check every 7 days
The following services are verified weekly:
- IT-aml
- IT-marketing
- IT-stakeholders
- IT-full
- IT-closed
- IT-vatgroup
- IT-sdicode
Check every 30 days
The following services are verified monthly:
- IT-Start
- IT-Advanced
- IT-shareholders
- IT-address
- IT-pec
- IT-name
- IT-ubo
- FR-Start
- FR-Advanced
- DE-Start
- DE-Advanced
- ES-Start
- ES-Advanced
- PT-Start
- PT-Advanced
- GB-start
- GB-Advanced
- BE-Start
- BE-Advanced
- AT-Start
- AT-Advanced
- CH-Start
- CH-Advanced
- PL-Start
- PL-Advanced
- WW-Start
- WW-Advanced
- WW-Top
The monitoring service has a standard duration of one year.
- If the autorenew parameter is set to false, the monitoring automatically ends after one year.
- If the autorenew parameter is set to true, the service is automatically renewed upon expiration, provided that sufficient credit is available on the account.
Yes. Simply set the autorenew parameter to false at activation or during monitoring management. In this case, the service will remain active until its natural annual expiration without renewal.
No. Thanks to the callback, the system sends proactive notifications in case of updates, eliminating the need to manually check the monitoring status or results.
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.
