# List all connected accounts

```http
GET https://api.synup.com/api/v4/connected-accounts
```

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)

Source: https://developer.synup.com/api/connected-accounts/list-all-connected-accounts

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `publisher` | string | optional | Type of connected accounts to filter by. Accepted values * `FacebookAccount`  * `GoogleAccount` |
| `status` | string | optional | Connection status to filter by. * `Connected` - Currently connected accounts * `ConnectionIssue` - Accounts with connection issues |
| `page` | integer | optional | Page number for pagination |
| `perPage` | integer | optional | Number of records per page |

## Example request

```bash
curl -X GET 'https://api.synup.com/api/v4/connected-accounts' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json'
```

## Responses

| Status | Description |
| --- | --- |
| `200` | Successfully retrieved connected accounts |
| `401` | Unauthorized - Invalid or missing API key |
| `403` | Forbidden - Insufficient permissions |
