# Fetch Connected Account Listings

```http
POST https://api.synup.com/api/v4/connected-accounts/connected-account-listings
```

This API retrieves all listings accessible to a specific Google My Business or Facebook Page account.

Features:
- Pagination support – Up to 500 records per page.
- Filtering options – Search by:
    - Street address
    - Postal code
    - City
    - Phone number
    - Business name

Source: https://developer.synup.com/api/connected-accounts/fetch-connected-account-listings

## Header parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `Content-Type` | string | required |  |

## Request body

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `connectedAccountId` | string | required | ID of the connected account to fetch listings for |
| `locationInfo` | string | optional | Optional filter string to search across location fields: - Street address - Postal code - City - Phone number - Business name |
| `page` | integer | optional | Page number for pagination |
| `perPage` | integer | optional | Number of records per page (maximum 500) |

## Example request

```bash
curl -X POST 'https://api.synup.com/api/v4/connected-accounts/connected-account-listings' \
  -H 'Authorization: API YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "connectedAccountId": "3db66afa-151d-4212-a8b7-949f9fe9aaf9"
}'
```

## Responses

| Status | Description |
| --- | --- |
| `200` | Successfully retrieved listings |
| `400` | Invalid request parameters |
| `401` | Unauthorized - Invalid or missing API key |
| `403` | Forbidden - Insufficient permissions |