# List location connections

```http
GET https://api.synup.com/api/v4/location-connections
```

This API returns a paginated list of your locations paired with each publisher (source), along with whether that location is connected, not connected, or has a connection issue for that publisher. It is the direct API equivalent of the <strong>Location Connections</strong> page.

Features:
- Pagination support – retrieve results in batches for efficient processing.
- Filtering options – filter location connections by:
    - Source / publisher (`source`)
    - Location id (`locationId`)
    - Location name / address / phone (`locationName`)
    - Connection status (`status`)
- Sorting – order by location info, publisher account email, or publisher type.

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

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `source` | string | optional | Publisher (source) to filter by. Accepted values * `GoogleAccount` * `FacebookAccount` * `AppleAccount` * `YelpAccount` * `TripadvisorAccount` |
| `locationId` | string | optional | Filter by one or more location ids. Accepts a raw numeric location id (e.g. `279169`) or a comma-separated list (e.g. `279169,279170`). Base64-encoded ids (`Location:<id>`) are also accepted. |
| `locationName` | string | optional | Free-text search across the location name, address, and phone number. |
| `status` | string | optional | Connection status to filter by. * `Connected` - location is connected to the source * `NotConnected` - location is not connected to the source * `ConnectionIssue` - location has a connection issue for the source |
| `sortField` | string | optional | Field to sort the results by. * `location_info` * `account_mail` * `account_type` |
| `sortOrder` | string | optional | Sort order. Only applied when `sortField` is provided. * `Ascending` * `Descending` |
| `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/location-connections' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json'
```

## Responses

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