Passer au contenu principal
Depuis le parcours acquéreur v3, une visite est un objet daté rattaché au match, pas une simple date posée sur la fiche. Ces routes permettent de les lire et de les écrire directement, sans passer par la liste générique des activités.
Pour lire les visites, préférez GET .../visits à GET Activities : la réponse est déjà filtrée sur les visites, triée par date de visite, et enrichie d’un derivedStatus.

Endpoints

Authentification : token LinkedAPI avec scope externalIntegration. Les routes POST et PATCH exigent l’autorisation en écriture sur ce scope — un token en lecture seule reçoit 403 Not authorized to access this resource. Clé requise : GET avec toutes les clés ; POST et PATCH en lecture-écriture (une clé en lecture seule reçoit 403). Voir Types de clé.
Écrire une visite déplace le match. Créer une visite promeut automatiquement le match à l’étape MVST s’il était à une étape antérieure. Annuler la dernière visite active le redescend à MCNV. Ces effets sont volontaires : ils alimentent l’inbox Prospect et les relances des agents. PATCH Match refuse MVST sur un match sans visite active : pour planifier une visite, créez-la ici.

Headers

GET — lister les visites

Path Parameters

Réponse

Les visites sont triées par data.visitStartAt décroissant (la plus récente d’abord).

data.derivedStatus

Calculé par Avest à la lecture, il évite de recalculer l’état côté client :

POST — créer une visite

Body Parameters

Si owner est absent, la visite est attribuée au responsable du match.

Exemple

Réponse 201 :

PATCH — modifier ou annuler une visite

Path Parameters

Body Parameters

Au moins un champ doit être fourni.
Il n’y a pas de suppression de visite via l’API. L’annulation (isCancelled: true) couvre le besoin et reste réversible ; elle conserve l’historique côté agent.

Réponses d’erreur

Un match hors périmètre répond « Unable to find match » : aucune différence n’est faite entre « n’existe pas » et « pas autorisé ».

Rate limits

GET : 500 req / minute. POST et PATCH : 100 req / minute (bucket d’écriture partagé avec les autres routes en écriture). Headers sur toutes les réponses : RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset.