Contact référentiel

Permet de récupérer les contacts du répertoire de référence Coefficy.

Récupérer les contacts référentiel

GET /v1/refVisitCard

Retourne la liste des contacts du référentiel avec leurs fonctions, coordonnées, données LinkedIn et informations de société. Les résultats sont triés par date de modification décroissante.

Headers

Nom	Type	Requis	Description
x-access-token	String	oui	Clé API

Paramètres query

Nom	Type	Requis	Description
idCompany	int|int[]	conditionnel	Identifiant(s) de société
siren	String|String[]	conditionnel	Numéro(s) SIREN
idRefVisitCard	int|int[]	conditionnel	Identifiant(s) du contact référentiel
email	String|String[]	conditionnel	Adresse(s) email
linkedinId	String|String[]	conditionnel	Identifiant(s) LinkedIn
domain	String|String[]	conditionnel	Nom(s) de domaine de la société
linkedinIdCompany	String|String[]	conditionnel	Identifiant(s) LinkedIn de la société
leftCompany	boolean	non	true = contacts ayant quitté, false = en poste
onlyCurrentFunctions	boolean	non	true = fonctions actives uniquement
polling	int	non	Contacts modifiés dans les X dernières minutes (min. 15)
limit	int	non	Nombre de résultats par page (défaut : 100)
offset	int	non	Décalage pour la pagination (défaut : 0)

TIP

Au moins un paramètre de filtrage est obligatoire.

Réponses

200 — OK

{
    "success": true,
    "code": 200,
    "parameters": {
        "idCompany": "int|null",
        "siren": "string|null",
        "limit": "int",
        "offset": "int",
        "idRefVisitCard": "[Int]|null",
        "linkedinId": "string",
        "leftCompany": "boolean",
        "onlyCurrentFunctions": "boolean",
        "domain": "string",
        "linkedinIdCompany": "string"
    },
    "refVisitCardList": [
        {
            "idRefVisitCard": "int",
            "firstName": "string",
            "lastName": "string",
            "email": "string|null",
            "phone": "string|null",
            "mobile": "string|null",
            "location": {
                "city": "string|null",
                "region": "string|null",
                "country": "string|null",
                "country_code": "string|null"
            }|null,
            "linkedinId": "string|null",
            "linkedinUrl": "string|null",
            "leftCompany": "boolean",
            "created": "datetime",
            "modified": "datetime",
            "company": {
                "idCompany": "int",
                "siren": "string",
                "name": "string",
                "commercialName": "string|null"
            },
            "functionList": [
                {
                    "name": "string",
                    "startDate": "datetime|null",
                    "endDate": "datetime|null",
                    "isCurrent": "boolean",
                    "location": {
                        "city": "string|null",
                        "region": "string|null",
                        "country": "string|null",
                        "Adresse1": "string|null",
                        "Adresse2": "string|null",
                        "country_code": "string|null"
                    }|null,
                    "personaMatchList": [
                        {
                            "idPersona": "int",
                            "title": "string",
                            "description": "string|null",
                            "order": "int|null",
                            "idPersonaRef": "int|null"
                        }
                    ]
                }
            ]
        }
    ]
}

TIP

personaMatchList est toujours un tableau (éventuellement vide []). Il contient les personas du compte dont au moins un intitulé-type configuré matche le name de la fonction (toutes les personas activées en mode "fiche société" du compte sont prises en compte, indépendamment de l'utilisateur qui les a créées).

400 — Bad Request

{
    "success": false,
    "code": 400,
    "message": "Au moins un paramètre de filtrage est requis"
}

403 — Forbidden

{
    "success": false,
    "code": 403,
    "message": "Accès refusé"
}