/api/v4/connected-accounts/{connectedAccountId}/detailsObtener los detalles de una cuenta conectada
Devuelve los detalles de una única cuenta de Google o Facebook conectada a partir de su ID.
Parámetros
Ruta
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| connectedAccountId | string | obligatorio | UUID of the connected account (from the list connected accounts endpoint). |
Respuestas
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.
Obtiene el registro completo de detalles de una única cuenta conectada, identificada por su connectedAccountId. Devuelve los mismos campos que un registro del endpoint de listado, pero limitados a una sola cuenta, lo que resulta menos costoso que recorrer todas las páginas del listado cuando ya tienes el ID.
Caso de uso: consultar periódicamente una cuenta recién conectada. Una vez que un cliente completa el flujo de conexión con Google, tienes un connectedAccountId, pero la obtención de coincidencias se ejecuta de forma asíncrona. Consulta periódicamente este endpoint y observa requestMatchesStatus: pasa de MATCH_IN_PROGRESS a MATCH_COMPLETED cuando las sugerencias están listas, momento en el que puedes leerlas en el endpoint connection-suggestions.
Caso de uso: mostrar un mensaje para volver a autenticarse. Antes de enviar actualizaciones a través de una cuenta, lee status y connectivityIssue. Un estado distinto de CONNECTED o un valor presente en connectivityIssue significa que la autorización OAuth ha caducado; pide al cliente que vuelva a conectar la cuenta en tu aplicación en lugar de intentar una publicación que fallará. connectedLocationsCount te indica cuántas ubicaciones de Listings API están vinculadas actualmente a la cuenta.
curl -X GET 'https://listingsapi.com/api/v4/connected-accounts/<connectedAccountId>/details' \ -H "Authorization: API $LISTINGSAPI_KEY"