curl --request POST \
--url https://partner.urbanora.fr/v1/contacts \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"ref": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({ref: '<string>'})
};
fetch('https://partner.urbanora.fr/v1/contacts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"statut": "en_cours",
"cible": {
"type": "entreprise",
"siren": "<string>",
"raison_sociale": "<string>",
"nom": "<string>",
"prenom": "<string>",
"qualite": "<string>",
"role_batiment": "<string>"
},
"canaux": [
{
"canal": "standard",
"statut": "en_cours",
"valeur": "<string>"
}
],
"credits": {
"pack": 123,
"consommes": 123,
"restants": 123
},
"cree_le": "<string>",
"termine_le": "<string>"
}{
"id": "<string>",
"statut": "en_cours",
"cible": {
"type": "entreprise",
"siren": "<string>",
"raison_sociale": "<string>",
"nom": "<string>",
"prenom": "<string>",
"qualite": "<string>",
"role_batiment": "<string>"
},
"canaux": [
{
"canal": "standard",
"statut": "en_cours",
"valeur": "<string>"
}
],
"credits": {
"pack": 123,
"consommes": 123,
"restants": 123
},
"cree_le": "<string>",
"termine_le": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"request_id": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"request_id": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"request_id": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"request_id": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"request_id": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"request_id": "<string>"
}Demander un contact
ref et canaux viennent du champ contact d’une entreprise ou d’un dirigeant de GET /v1/batiment. Entreprise : standard. Dirigeant : email_pro, linkedin, et selon le contrat email_perso, mobile. Sans canaux : le standard pour une entreprise, email pro et LinkedIn pour un dirigeant. La recherche peut prendre plusieurs minutes : la réponse arrive tout de suite (202 si en cours), relire GET /v1/contacts/{id}. Un canal trouvé consomme les crédits du contrat ; introuvable ou échec ne coûte rien. Un contact déjà obtenu par votre organisation est rendu sans nouveau débit. Coût par canal : contact.credits sur la fiche (perso et mobile : 2 crédits selon le contrat). Pack épuisé : 402 CREDITS_EPUISES, avant toute recherche ; contrat terminé : 403 CONTRACT_ENDED.
curl --request POST \
--url https://partner.urbanora.fr/v1/contacts \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"ref": "<string>"
}
'const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({ref: '<string>'})
};
fetch('https://partner.urbanora.fr/v1/contacts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"statut": "en_cours",
"cible": {
"type": "entreprise",
"siren": "<string>",
"raison_sociale": "<string>",
"nom": "<string>",
"prenom": "<string>",
"qualite": "<string>",
"role_batiment": "<string>"
},
"canaux": [
{
"canal": "standard",
"statut": "en_cours",
"valeur": "<string>"
}
],
"credits": {
"pack": 123,
"consommes": 123,
"restants": 123
},
"cree_le": "<string>",
"termine_le": "<string>"
}{
"id": "<string>",
"statut": "en_cours",
"cible": {
"type": "entreprise",
"siren": "<string>",
"raison_sociale": "<string>",
"nom": "<string>",
"prenom": "<string>",
"qualite": "<string>",
"role_batiment": "<string>"
},
"canaux": [
{
"canal": "standard",
"statut": "en_cours",
"valeur": "<string>"
}
],
"credits": {
"pack": 123,
"consommes": 123,
"restants": 123
},
"cree_le": "<string>",
"termine_le": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"request_id": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"request_id": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"request_id": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"request_id": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"request_id": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>"
},
"request_id": "<string>"
}Autorisations
Corps
Réponse
Default Response