/api/v4/connected-accounts/{connectedAccountId}/detailsObtenir les détails d’un compte connecté
Renvoie les détails d’un seul compte Google ou Facebook connecté à partir de son ID.
Paramètres
Chemin
| Nom | Type | Obligatoire | Description |
|---|---|---|---|
| connectedAccountId | string | obligatoire | UUID of the connected account (from the list connected accounts endpoint). |
Réponses
200Connected account details.
{ "data": { "connectedAccountDetails": { "details": { "accountId": "12345", "clientName": "owner@brightsmile-dental.com", "connectedAccountId": "4f712c17-4f95-42dd-90f4-97171a2e67b5", "connectedAccountType": "GoogleAccount", "connectedLocationsCount": 0, "connectivityIssue": null, "email": "owner@brightsmile-dental.com", "lastFetchMatchesRequestedAt": "2026-07-06 21:43:07 UTC", "remarks": null, "requestMatches": false, "requestMatchesStatus": "MATCH_COMPLETED", "status": "CONNECTED" } } }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
Récupère l’enregistrement détaillé complet d’un seul compte connecté, identifié par son connectedAccountId. Cette opération renvoie les mêmes champs qu’un enregistrement de l’endpoint de liste, mais pour un seul compte, ce qui est moins coûteux que de parcourir toutes les pages de la liste lorsque vous disposez déjà de l’ID.
Cas d’utilisation : interroger régulièrement un compte qui vient d’être connecté. Une fois que le client a terminé le parcours de connexion à Google, vous disposez d’un connectedAccountId, mais la récupération des correspondances s’effectue de manière asynchrone. Interrogez régulièrement cet endpoint et surveillez requestMatchesStatus : sa valeur passe de MATCH_IN_PROGRESS à MATCH_COMPLETED lorsque les suggestions sont prêtes, et vous pouvez alors les consulter via l’endpoint connection-suggestions.
Cas d’utilisation : afficher un message demandant une réauthentification. Avant d’envoyer des mises à jour via un compte, consultez status et connectivityIssue. Un statut autre que CONNECTED ou un champ connectivityIssue renseigné signifie que l’autorisation OAuth a expiré ; invitez le client à se reconnecter dans votre application au lieu de tenter une publication qui échouera. connectedLocationsCount vous indique combien d’établissements Listings API sont actuellement liés au compte.
curl -X GET 'https://listingsapi.com/api/v4/connected-accounts/<connectedAccountId>/details' \ -H "Authorization: API $LISTINGSAPI_KEY"