---
title: "Fetch Connected Account Listings"
method: POST
path: "/connected-accounts/connected-account-listings"
tags: ["Connected Accounts"]
---

# Fetch Connected Account Listings

`POST /connected-accounts/connected-account-listings`

## Request

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

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

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

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

## Response `200`

Successfully retrieved listings

- FetchListingsResponseV2
  - `data` object
    - `connectedAccountListings` 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` LocationListingV2[]
        - `accountTypeName` 'Google' | 'Facebook': Publisher type of the listing
        - `address` string: Full address of the location
        - `id` string: Reference Listing ID that can be used to connect a location
        - `liveLink` string, nullable: Live link provided by Google/Facebook if available
        - `locationName` string: Name of the location
        - `phone` string: Phone number of the location
        - `type` string, nullable: Type of the listing if specified
        - `ownerRole` string, nullable: GBP role of the connecting/importing user on this listing (e.g. PRIMARY_OWNER, OWNER, MANAGER, SITE_MANAGER). Google (GMB) only; null when Google exposes no matching admin or for non-Google listings.

## Other responses

- `400`: Invalid request parameters
- `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)