---
title: "Get all Listings for a specific Location"
method: GET
path: "/locations/{id}/listings-details/list"
tags: ["Listings"]
---

# Get all Listings for a specific Location

`GET /locations/{id}/listings-details/list`

## Request

- Base URL: `https://workflows.promorepublic.com/webhook/2637089f-b543-45d0-a83e-2334aada4ead/listings/sandbox/api`
- URL: `https://workflows.promorepublic.com/webhook/2637089f-b543-45d0-a83e-2334aada4ead/listings/sandbox/api/locations/{id}/listings-details/list`
- Auth: HTTP bearer

Lists all the details of all Listings for a specific Location

## Path parameters

- `id` string, required

## Response `200`

Listings details successfully retrieved

- object
  - `status` 'SUCCESS' | 'PENDING' | 'QUOTA_LIMIT_EXCEED' | 'NOT_AUTHORIZED' | 'FORBIDDEN' | 'BAD_ACCESS_TOKEN' | 'BAD_PRIVATE_KEY' | 'BAD_PUBLIC_KEY' | 'MISSING_PARAMETER' | 'INVALID_PARAMETER' | 'WRONG_PARAMETER_TYPE' | 'CONFLICT' | 'RESOURCE_LOCKED' | 'SERVER_ERROR' | 'ERROR' | 'NOT_FOUND' | 'BAD_REQUEST' | 'USER_ERROR' | 'PARTIAL_ERROR' | 'SERVICE_TEMPORARILY_UNAVAILABLE', required
  - `message` string: (optional) Holds further information about the response
  - `warnings` string[]: (optional) Holds further warnings
  - `response` object, required: Listings details response model
    - `statistic` object: Statistics or count of listings in different statuses
      - `totalListings` integer: Total Listings
      - `countListingsInSync` integer: Count of Listings in sync
      - `countListingsSubmitted` integer: Count of Listings where the latest information has been submitted successfully (however the publisher does not have an online verification)
      - `countListingsBeingUpdated` integer: Count of Listings which are being updated
      - `countListingsLinked` integer: Count of Listings which we have linked but do not update location data
      - `countListingsActionRequired` integer: Count of Listings where action is required by the customer
      - `countListingsScheduled` integer: Count of listings scheduled to go live once the location's opening date is reached. Not part of totalListings. Available from version 20260701.
    - `listingsResponse` object[]: Detailed response for the listings
      - `type` string: The directory where this listing appears
      - `typeName` string: Listing type / Publisher name
      - `category` string: The category of the directory of this listing
      - `id` integer: The id of the listing details
      - `listingUrl` string: Listing URL
      - `mandatoryFieldsMissing` string[]: Mandatory field missing on the location which prevents the data to be submitted to the publisher
      - `directorySpecificData` object: Directory specific data. e.g. Google publishing states which can be VERIFIED, UNVERIFIED, DISABLED, SUSPENDED, DUPLICATE, NEEDS_REVERIFICATION, PENDING_VERIFICATION.
        - `requestAdminRightsUrl` string
        - `status` string
      - `directoryContactDetails` object: Contact details of the publisher when the listing needs to be claimed
        - `email` string: Email address to be used to release a claim from another provider
        - `website` string: Contact website address to be used to release a claim from another provider
      - `directoryConnectInfo` object: Directory Connect Info model
        - `status` 'CONNECTED' | 'NOT_CONNECTED' | 'NOT_NEEDED': Listing Connect Status [CONNECTED, NOT_CONNECTED, NOT_NEEDED]
        - `userDetails` object: Connect Flow User Details model
          - `id` integer: Connected account detail (Account id)
          - `name` string: Connected account detail (Account name)
          - `email` string: Connected account detail (email)
          - `dateConnected` string, date-time: his should indicate the date that this user made the connection
          - `defaultForSalesPartner` boolean: This should indicate whether the connection in place has been produced by a salesPartner level connection
          - `defaultForBusiness` boolean: This should indicate whether the connection in place has been produced by a business level connection
      - `status` 'SYNCED' | 'SUBMITTED' | 'UPDATING' | 'LINKED' | 'ACTION_REQUIRED' | 'SCHEDULED': Listing Status [SYNCED, SUBMITTED, UPDATING, ACTION_REQUIRED, LINKED]
      - `action` 'CONNECT' | 'VERIFY' | 'CLAIM' | 'ADD_MANDATORY_FIELDS' | 'ACCESS' | 'RESOLVE_PERMISSION_ISSUES': Action Required [CONNECT, VERIFY, CLAIM, ADD_MANDATORY_FIELDS, ACCESS]
      - `lastUpdateAttempt` string, date-time: Timestamp of our most recent push attempt to the directory. Available from version 20260701.
      - `expectedSyncDuration` number: Expected time, in decimal hours, until an UPDATING listing becomes synced on this directory. Available from version 20260701.
    - `firstSyncStarted` string, date-time: Date & time the first sync was started on the location.
    - `lastSyncStarted` string, date-time: Date and time the most recent sync was started on the location. Available from version 20260701.
    - `autoSyncEnabled` boolean: Whether automatic sync is enabled for the location. Available from version 20260701.
    - `openingSoon` boolean: True when the location's opening date is in the future. Available from version 20260701.
    - `openingDate` string, date: The location's opening date, relevant when openingSoon is true. Available from version 20260701.

## Other responses

- `400`: Bad Request - The request was invalid or cannot be otherwise served
- `401`: Unauthorized - Authentication credentials are missing or invalid
- `403`: Forbidden - The request is understood, but has been refused or access is not allowed
- `404`: Not Found - The requested resource could not be found

---

[API](https://skmtc.dev/promorepublic/apis/listings-api.md) - [All operations](https://skmtc.dev/promorepublic/apis/listings-api/llms.txt) - [OpenAPI document](https://skmtc.dev/promorepublic/apis/listings-api/revisions/a04c07676a6e?raw)