---
title: "List all connected accounts"
method: GET
path: "/connected-accounts"
tags: ["Connected Accounts"]
---

# List all connected accounts

`GET /connected-accounts`

## Request

- Base URL: `https://api.synup.com/api/v4`
- URL: `https://api.synup.com/api/v4/connected-accounts`
- Auth: none required
- TypeScript: <https://skmtc.dev/synup/apis/synup-api/docs/connected-accounts/get.ts> (a function with typed inputs; its response is checked against the schema)

This API retrieves a paginated list of all connected accounts under your account, with support for filtering by publisher type and connection status.

Features:
- Pagination support – Retrieve results in batches for efficient processing.
- Filtering options – Filter connected accounts by:
    - Publisher type (Google My Business, Facebook, etc.)
    - Connection status (Active, Expired, Disconnected)

## Query parameters

- `publisher` 'FacebookAccount' | 'GoogleAccount'
- `status` 'Connected' | 'ConnectionIssue'
- `page` integer
- `perPage` integer

## Headers

- `Authorization` string, required

## Response `200`

Successfully retrieved connected accounts

- ConnectedAccountsResponseV2
  - `data` object
    - `connectedAccountsInfo` object
      - `pageInfo` PageInfoV2
        - `hasNextPage` boolean: Indicates if there are more pages available
        - `hasPreviousPage` boolean: Indicates if there are previous pages available
        - `totalPages` integer: Total number of pages available
        - `totalRecords` integer: Total number of records across all pages
      - `records` ConnectedAccountV2[]
        - `connectedAccountId` string: Unique identifier of the connected account
        - `connectedAccountType` 'GoogleAccount' | 'FacebookAccount': Type of the connected account
        - `connectedLocationsCount` integer: Number of locations connected with this account
        - `connectivityIssue` string, nullable: Type of connectivity issue if any: * `CONNECTED_LOCATIONS_ISSUE` - Connected to inaccessible listings * `CREDENTIALS_INVALIDATED` - Expired credentials
        - `email` string, email: Email address associated with the connected account
        - `lastFetchMatchesRequestedAt` string, date-time: Timestamp of the last matches request
        - `requestMatches` boolean: Indicates if the account can trigger matches
        - `requestMatchesStatus` string: Status of the last request matches triggered
        - `status` 'CONNECTED' | 'ConnectionIssue': Current connection status
        - `remarks` string, nullable: Additional information about account status or errors

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `403`: Forbidden - Insufficient permissions

---

[API](https://skmtc.dev/synup/apis/synup-api.md) - [All operations](https://skmtc.dev/synup/apis/synup-api/llms.txt) - [OpenAPI document](https://skmtc.dev/synup/apis/synup-api/revisions/67de2d51c22e?raw)