---
title: "Get premium listings"
method: GET
path: "/locations/{locationId}/listings/premium"
tags: ["Listings"]
---

# Get premium listings

`GET /locations/{locationId}/listings/premium`

## Request

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

This API retrieves all premium listings associated with a specific location.

**Response Includes:**
- Sync status – Indicates whether the listing is synced successfully.
- Display status – Shows whether the listing is live on the platform.
- Platform details – Includes directories such as Google Maps, Apple Maps, and other listing sites.

## Path parameters

- `locationId` string, required

## Headers

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

## Response `200`

Premium listings retrieved successfully

- object
  - `data` object
    - `listingsForLocation` object[]
      - `id` string: Node ID of the listing
      - `databaseId` string: Database ID of the listing
      - `site` object
        - `id` string: Node ID of the directory site
        - `databaseId` string: Database ID of the directory site
        - `name` string: Name of the directory site
        - `url` string: URL of the directory site
        - `syScore` string: Synup score for the directory
      - `syncStatus` 'IN_PROGRESS' | 'SYNCED' | 'FAILED' | 'REQUIRING_ACTION' | 'AVAILABLE' | 'COMPLETED' | 'PENDING_APPROVAL': Current sync status of the listing
      - `displayStatus` string, nullable: Human-readable status message
      - `actionRequired` boolean: Whether user action is required
      - `listingUrl` string: URL of the live listing
      - `connectedAccountId` string, required: gives the connected_account_id its mapped to
      - `lastUpdate` string, required: last updated at date
      - `indexStatus` boolean, required: SOV index status
      - `syncIssue` string, required: error while syncing
      - `verfied` boolean, required: check if this listing is verified

---

[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)