0,70 € + TVA
Obtenez le numéro de téléphone, fixe ou mobile, d'un professionnel libéral à partir du paramètre code fiscal, le tout via API.
Le service Numéro Téléphone Freelance appartient à l'API RISK et permet d'obtenir, à partir du paramètre code fiscal, le numéro de téléphone d'un professionnel.
Le service est identifié par l'endpoint https://risk.openapi.com/FR-telephones.
POST/telephones
La méthode à utiliser dans la demande est POST :
POST https://risk.openapi.com/FR-telephones
Les paramètres à passer dans le body de la demande sont :
Ceci est un exemple des paramètres nécessaires pour une demande avec le code fiscal DRSCLD70P15H501V :
{
"cf_piva": "RSSMRA90D15L117D",
"callback": {
"url": "https://yourdomain.com/your_script",
"field": "data",
"method": "POST",
"headers": {
"session_id": "oiwejdf89453urf945jfg"
}
}
}
La réponse est asynchrone. Il est possible de configurer, lors de la demande, un callback pour être informé lorsque les données seront disponibles, sans avoir à appeler plusieurs fois l'endpoint GET /request/{id} pour en vérifier l'état.
POST /telephones
Voici un exemple de réponse en attente (PENDING) où il sera possible d'obtenir l'id de la demande à utiliser dans un second appel pour accéder aux données souhaitées.
{
"data": {
"id": "60e866b6b3178c6dc80adf8e",
"cf_piva": "RSSMRA90D15L117D",
"type": [
"telephones"
],
"callback": false,
"url" false,
"field" data,
"method" POST,
"data": false,
"headers": {
"session_id": ""oiwejdf89453urf945jfg""
}
"result": "null"
"timestamp": "null"
"owner": "test@openapi.com"
"subject": "null"
"status": "PENDING",
"date_request": "null",
"date_completion": "null",
},
"success": true,
"message": "",
"error": null
}
GET /FR-demande/{id}
Pour obtenir les données, il sera nécessaire d'effectuer une deuxième demande, comme indiqué précédemment, à un autre point de terminaison avec l'ID précédemment obtenu.
POST https://risk.openapi.com/FR-demande/60e866b6b3178c6dc80adf8e
GET /FR-demande/{id}
Dans la réponse, il sera possible d'accéder au numéro de téléphone, fixe ou mobile, en fonction de la disponibilité.
{
"data": {
"status": "COMPLETED",
"date_request": "2023-07-09 17:09:42",
"date_completion": "2023-07-09 17:40:57",
"id": "60e866b6b3178c6dc80adf8e",
"cf_piva": "RSSMRA90D15L117D",
"tipo": [
"téléphones"
],
"callback": null,
"esito": {
"codice": 200,
"info": "OK"
},
"timestamp": 1625232029,
"owner": "entreprises@openapi.fr",
"soggetto": {
"code": "RSSMRA90D15L117D"
"utenze": ["3331234567"]
]
},
"success": true,
"message": "",
"error": null
}
Le service Numéro Téléphone Freelance est également disponible pour des recherches sur Particuliers et Entreprises.
MODALITÉS ET CONDITIONS D'UTILISATION DU SERVICE
Il est rappelé que ce service ne peut être demandé que s'il existe un droit juridiquement pertinent (toute position subjective configurant une relation d'instrumentalité entre cet intérêt et la documentation dont la divulgation est demandée).
De par sa nature, le service peut également fournir une réponse nulle (par exemple, aucune donnée dans les bases de données publiques ou accessibles au public), ce service implique également un coût dans ce cas. Le client, au moment de la demande, déclare avoir un droit pertinent (par exemple, recouvrement de créances), en cas de fausse déclaration, il est rappelé que la demande est communiquée trimestriellement aux bureaux de la Préfecture avec les conséquences relatives aux fausses déclarations.
Le service, bien qu'il soit disponible en mode automatique via API, est soumis pour des raisons réglementaires à une surveillance continue des LOG avec les limitations suivantes :
- le service est actif de 9h à 19h
- le service est actif uniquement les jours ouvrables
- le rate limit est configuré automatiquement pour chaque client en fonction des volumes annuels achetés
Les demandes effectuées en dehors des heures ou des jours ouvrables sont mises en file d'attente et traitées en priorité le premier jour ouvrable.
Le service, comme indiqué dans les conditions contractuelles, a des limites de débit quotidiennes définies pour une gestion correcte du service.
Si vous souhaitez un service personnalisé, contactez-nous ici.
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!
Avec le service Téléphone Professionnel Indépendant, il est possible d'obtenir le numéro de téléphone à partir du code fiscal.
La vérification aide à prévenir la fraude, les abus et les erreurs et garantit que les transactions commerciales et administratives se déroulent avec des entités légitimes et enregistrées.
Le service de numérotation est fourni par un opérateur autorisé TULPS, qui obtient les coordonnées via des centres d'appels et la consultation de répertoires publics, ainsi que des contacts fournis par les clients avec l'autorisation d'usage externe.
Veuillez noter que ce service ne peut être demandé qu’en présence d’un droit juridiquement pertinent, c’est-à-dire qu’il doit exister une base légale justifiant l’accès aux informations demandées et établissant un lien entre l'intérêt du demandeur et la documentation recherchée.
Le service peut, par nature, ne donner aucun résultat (par exemple, si aucune donnée n'est disponible dans les bases de données publiques ou d’accès public). Même en l'absence de résultats, des frais de service sont appliqués.
Lors de la soumission de la demande, le client déclare avoir un droit juridiquement pertinent (par exemple, à des fins de recouvrement de créances). En cas de fausse déclaration, il est à noter que la demande sera signalée trimestriellement à la Préfecture, avec les conséquences légales prévues pour les fausses déclarations.
Le service est utile pour les agences de recouvrement de créances, les avocats, les banques et les cabinets d'avocats qui ont un intérêt légitime à contacter des personnes physiques ou morales en raison d'obligations financières en suspens, ou pour la notification d'actes et de documents juridiques.
Le coût par demande unique est de 0,70 €.