Grâce à un endpoint dédié, il est possible d’activer un service de surveillance sur les services Company, afin de recevoir des notifications en cas de mises à jour concernant les données de l’entreprise d’intérêt.
En configurant un callback, le système enverra automatiquement une notification chaque fois que des modifications seront détectées. La fréquence des vérifications varie selon le service sélectionné ; voici quelques exemples :
- Tous les 7 jours pour les services : IT-aml, IT-marketing, IT-stakeholders, IT-full, IT-closed, IT-vatgroup, IT-sdicode
- Tous les 30 jours pour les 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
La surveillance a une durée de 12 mois.
- Si autorenew = false, le service expirera automatiquement à la fin de la période.
- Si autorenew = true, la surveillance sera renouvelée automatiquement, sous réserve de crédit suffisant.
Une solution idéale pour intégrer des contrôles continus, des processus d’onboarding, de lutte contre le blanchiment (AML) et de conformité directement dans vos flux applicatifs.
EXEMPLE DE REQUÊTE
POST /monitor
Cet endpoint permet de créer une nouvelle demande de surveillance pour une entreprise. Si un callback a été configuré, vous recevrez une notification lors du premier contrôle et chaque fois qu’un ou plusieurs champs configurés pour la surveillance changent.
{
"code": "12485671007",
"dataset": "IT-advanced",
"monitoredFields": [
"activityStatus"
],
"callback": {
"url": "https://webhook.site/f24cec85-22e3-4f7c-8ec0-227b240daa42"
}
}Pour tous les datasets autres que IT et FR, si au moment de la requête aucune entreprise n’est trouvée avec le code fourni dans le payload, en plus de l’erreur 404, des frais de recherche seront également facturés au coût du dataset sélectionné.
EXEMPLE DE RÉPONSE
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
}EXEMPLE DE REQUÊTE SPÉCIFIQUE
GET/monitor/{id}
Endpoint qui renvoie la demande identifiée par l’identifiant passé dans le chemin.
Dans un environnement de test, il est possible d’effectuer un appel synchrone simulant le contrôle du système sur les champs de l’entreprise que vous souhaitez surveiller. Il suffit d’exécuter une requête GET sur cette 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
}SUPPRIMER LA DEMANDE
Via l’endpoint DELETE/monitor/{id} il est possible de supprimer une surveillance d’entreprise
{
"data": [],
"success": true,
"message": "1 deleted monitor",
"error": null
}
Avez-vous besoin d'aide ?
Vous n'avez pas trouvé la réponse que vous cherchiez?
Remplissez tous les détails, nous vous contacterons dès que possible!
Le service de surveillance Company permet de suivre dans le temps les informations d’entreprise d’intérêt. Grâce à un endpoint dédié, le système vérifie périodiquement les éventuelles mises à jour des données et notifie automatiquement le client en cas de modifications.
Il est possible de configurer une URL de callback. Lorsque le système détecte une modification par rapport aux données précédemment disponibles, il envoie une notification automatique à la callback configurée, sans qu’il soit nécessaire d’effectuer des contrôles manuels ou des requêtes périodiques.
La fréquence des contrôles dépend du service de surveillance activé. Actuellement, deux intervalles sont prévus :
Contrôle tous les 7 jours
Les services suivants sont vérifiés chaque semaine :
- IT-aml
- IT-marketing
- IT-stakeholders
- IT-full
- IT-closed
- IT-vatgroup
- IT-sdicode
Contrôle tous les 30 jours
Les services suivants sont vérifiés chaque mois :
- 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
Le service de surveillance a une durée standard d’un an.
- Si le paramètre autorenew est défini sur false, la surveillance prend automatiquement fin après un an.
- Si le paramètre autorenew est défini sur true, le service est renouvelé automatiquement à l’échéance, sous réserve de crédit suffisant sur le compte.
Oui. Il suffit de définir le paramètre autorenew sur false lors de l’activation ou pendant la gestion de la surveillance. Dans ce cas, le service restera actif jusqu’à son échéance annuelle naturelle sans renouvellement.
Non. Grâce à la callback, le système envoie des notifications proactives en cas de mises à jour, éliminant la nécessité de vérifier manuellement l’état ou les résultats de la surveillance.
Énergie sans carbone pour notre nuage 
Low CO2
Openapi SpA Unipersonale - Société soumise à la direction et au contrôle de Open Holding Srl - Viale Filippo Tommaso Marinetti 221 - 00143 Rome - Registre des Entreprises REA 1378273 - Capital social € 50.000,00 entièrement versé – N° TVA IT12485671007 - Code destinataire 'USAL8PV' - PEC : 
Openapi est certifiée : Système de gestion de la qualité UNI EN ISO 9001:2015 - Qualité des données ISO 25012:2014 - Gestion de la sécurité ISO/IEC 27001:2022 - Égalité des sexes selon UNI PdR 125:2022
Tous les prix sont à considérer hors TVA éventuelle, droits de timbre éventuels, frais de secrétariat et/ou taxes ou impôts autrement désignés s'ils sont dus. Tous les logos mentionnés sur le portail sont protégés par des droits d'auteur et appartiennent à leurs propriétaires respectifs.
