Passer au contenu principal
Recherche les matchs (rapprochements acquisition / vente) rattachés à une vente et/ou une acquisition.

Endpoint

URL : /external-integration/match/search Méthode : GET Authentification : Requiert un token LinkedAPI avec scope externalIntegration et une clé rattachée à un groupe d’agences. Clé requise : toutes les clés (lecture seule suffit). Voir Types de clé.

Headers

Query Parameters

Au moins un des deux paramètres suivants doit être fourni :
Au moins un des deux paramètres (sale ou acquisition) doit être fourni. Les deux peuvent être fournis simultanément.

Exemples de requête

Réponse de succès

Code : 200 Les matchs sont retournés triés par createdAt décroissant (les plus récents en premier), dans la limite de 200 résultats.

Aucun résultat

Champs de la réponse

Chaque élément de matches :

Réponses d’erreur

  • Aucun paramètre fourni : 400 Bad Request
  • LinkedAPI agencyGroup manquant : 400 Bad Request
  • Header Authorization absent, ou IP non whitelistée sur une clé sécurisée : 403 Not authorized to access this resource
  • Token invalide : 401 Invalid bearer token

Notes

  1. Scope : seuls les matchs de votre périmètre autorisé sont retournés.
  2. Limite : au maximum 200 matchs sont retournés, triés par createdAt décroissant.
  3. Croisement : sale et acquisition sont les ObjectIds à utiliser avec GET /external-integration/sale et GET /external-integration/acquisition.
  4. Endpoint en lecture seule.

Rate limits

Cette route est limitée à 200 req / minute par groupe d’agences (bucket dédié).
  • Headers : RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset (secondes avant reset).
  • Dépassement → 429 Too Many Requests avec header Retry-After :