Passer au contenu principal
GET
Lister des contacts (paginé)

Autorisations

Authorization
string
header
requis

Token LinkedAPI avec scope externalIntegration. La clé doit avoir un agencyGroup configuré (sinon 400 LinkedAPI agencyGroup is required). Fourni via l'en-tête Authorization: Bearer {linkedAPI_token}. Si la clé a secure === true, l'IP appelante doit être whitelistée (en-tête X-Real-IP), sinon 403 Not authorized to access this resource.

La clé porte aussi un niveau d'accès : en lecture seule, elle n'autorise que les GET ; un POST ou un PATCH renvoie alors 403 Not authorized to access this resource, soit la même réponse qu'une requête sans en-tête Authorization. Voir le guide Authentification.

Paramètres de requête

phone
string

Numéro de téléphone. Formats acceptés : +33612345678, 0612345678, 06 12 34 56 78. Match exact. Mutuellement exclusif avec email et search.

email
string<email>

Adresse email. Match exact (normalisé en minuscules). Mutuellement exclusif avec phone et search.

Texte libre — minimum 3 caractères. Recherche sur nom, email, téléphone. Mutuellement exclusif avec phone et email.

Minimum string length: 3
page
integer
défaut:1

Page 1-indexée. Défaut 1. Max 100.

Plage requise: 1 <= x <= 100

Réponse

Liste paginée de contacts.

success
boolean
contacts
object[]
page
integer
limit
integer

Taille de page (fixe, non paramétrable). ⚠️ Ce champ s'appelle limit ici, mais pageSize sur /activities et /ad/search — deux noms pour la même chose, historique et conservé pour ne pas casser les intégrations existantes.

hasMore
boolean