listingsAPIlistingsAPI
Get API keySign in
GET/api/v4/connected-accounts/{connectedAccountId}/details

Get connected account details

Returns the details of a single connected Google or Facebook account by its ID.

Requires an API key. See Authentication for header format and key rotation.

Parameters

Path

NameTypeRequiredDescription
connectedAccountIdstringrequiredUUID of the connected account (from the list connected accounts endpoint).

Responses

200Connected account details.
{
  "data": {
    "connectedAccountDetails": {
      "details": {
        "accountId": "62670",
        "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.

Fetches the full detail record for a single connected account, addressed by its connectedAccountId. This returns the same fields as one record from the list endpoint, but scoped to one account, which is cheaper than paging the whole list when you already hold the ID.

Use case — poll a freshly connected account. After a customer completes the Google connect flow you hold a connectedAccountId but the match fetch runs asynchronously. Poll this endpoint and watch requestMatchesStatus: it moves from MATCH_IN_PROGRESS to MATCH_COMPLETED once suggestions are ready, at which point you can read them from the connection-suggestions endpoint.

Use case — surface a re-auth prompt. Before pushing updates through an account, read status and connectivityIssue. A non-CONNECTED status or a populated connectivityIssue means the OAuth grant has expired; show the customer a re-connect button instead of attempting a publish that will fail. connectedLocationsCount tells you how many listingsAPI locations are currently linked to the account.

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