/api/v4/connected-accounts/{connectedAccountId}/detailsDetails eines verbundenen Kontos abrufen
Gibt die Details eines einzelnen verbundenen Google- oder Facebook-Kontos anhand seiner ID zurück.
Parameter
Pfad
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| connectedAccountId | string | erforderlich | UUID of the connected account (from the list connected accounts endpoint). |
Antworten
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.
Ruft den vollständigen Detaildatensatz eines einzelnen verbundenen Kontos ab, das über seine connectedAccountId adressiert wird. Dabei werden dieselben Felder wie in einem Datensatz des Listenendpunkts zurückgegeben, jedoch auf ein Konto beschränkt, was weniger Aufwand verursacht als das seitenweise Abrufen der gesamten Liste, wenn Ihnen die ID bereits vorliegt.
Anwendungsfall: ein neu verbundenes Konto regelmäßig abfragen. Nachdem ein Kunde den Verbindungsablauf für Google abgeschlossen hat, liegt Ihnen eine connectedAccountId vor, aber der Abruf der Übereinstimmungen erfolgt asynchron. Fragen Sie diesen Endpunkt regelmäßig ab und beobachten Sie requestMatchesStatus: Der Wert wechselt von MATCH_IN_PROGRESS zu MATCH_COMPLETED, sobald Vorschläge verfügbar sind. Ab diesem Zeitpunkt können Sie diese über den Endpunkt connection-suggestions abrufen.
Anwendungsfall: eine Aufforderung zur erneuten Authentifizierung anzeigen. Lesen Sie vor der Übermittlung von Aktualisierungen über ein Konto status und connectivityIssue aus. Ein anderer Status als CONNECTED oder ein ausgefülltes Feld connectivityIssue bedeutet, dass die OAuth-Autorisierung abgelaufen ist; fordern Sie den Kunden auf, die Verbindung in Ihrer App erneut herzustellen, statt eine Veröffentlichung zu versuchen, die fehlschlagen wird. connectedLocationsCount gibt an, wie viele Standorte der Listings API derzeit mit dem Konto verknüpft sind.
curl -X GET 'https://listingsapi.com/api/v4/connected-accounts/<connectedAccountId>/details' \ -H "Authorization: API $LISTINGSAPI_KEY"