GET/api/v4/connected-accounts/{connectedAccountId}/details

Ottieni i dettagli di un account collegato

Restituisce i dettagli di un singolo account Google o Facebook collegato tramite il suo ID.

Richiede una chiave API. Consulta Autenticazione per il formato dell’header e la rotazione delle chiavi.

Parametri

Percorso

NomeTipoObbligatorioDescrizione
connectedAccountIdstringobbligatorioUUID of the connected account (from the list connected accounts endpoint).

Risposte

200Connected account details.
Response
{  "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.

Recupera il record completo dei dettagli di un singolo account collegato, identificato dal suo connectedAccountId. Restituisce gli stessi campi di un record dell'endpoint di elenco, ma limitatamente a un solo account, con un costo inferiore rispetto alla consultazione di tutte le pagine dell'elenco quando disponi già dell'ID.

Caso d'uso: interroga periodicamente un account appena collegato. Dopo che un cliente completa la procedura di collegamento a Google, disponi di un connectedAccountId, ma il recupero delle corrispondenze viene eseguito in modo asincrono. Interroga periodicamente questo endpoint e monitora requestMatchesStatus: passa da MATCH_IN_PROGRESS a MATCH_COMPLETED quando i suggerimenti sono pronti, e a quel punto puoi leggerli dall'endpoint connection-suggestions.

Caso d'uso: mostra un messaggio per ripetere l'autenticazione. Prima di inviare aggiornamenti tramite un account, leggi status e connectivityIssue. Uno stato diverso da CONNECTED o un campo connectivityIssue valorizzato indica che l'autorizzazione OAuth è scaduta; invita il cliente a ricollegare l'account nella tua app invece di tentare una pubblicazione destinata a fallire. connectedLocationsCount indica quante sedi di Listings API sono attualmente collegate all'account.

Request
curl -X GET 'https://listingsapi.com/api/v4/connected-accounts/<connectedAccountId>/details' \  -H "Authorization: API $LISTINGSAPI_KEY"