# Get all Listings for a specific Location

Lists all the details of all Listings for a specific Location

Endpoint: GET /locations/{id}/listings-details/list
Version: 20250708
Security: X-API-KEY, Authorization

## Path parameters:

  - `id` (string, required)
    The uberall unique id of the location

## Response 200 fields (*/*):

  - `status` (string, required)
    Enum: "SUCCESS", "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"

  - `message` (string)
    (optional) Holds further information about the response

  - `warnings` (array)
    (optional) Holds further warnings

  - `response` (object, required)
    Listings details response model

  - `response.statistic` (object)
    Statistics or count of listings in different statuses

  - `response.statistic.totalListings` (integer)
    Total Listings

  - `response.statistic.countListingsInSync` (integer)
    Count of Listings in sync

  - `response.statistic.countListingsSubmitted` (integer)
    Count of Listings where the latest information has been submitted successfully (however the publisher does not have an online verification)

  - `response.statistic.countListingsBeingUpdated` (integer)
    Count of Listings which are being updated

  - `response.statistic.countListingsLinked` (integer)
    Count of Listings which we have linked but do not update location data

  - `response.statistic.countListingsActionRequired` (integer)
    Count of Listings where action is required by the customer

  - `response.listingsResponse` (array)
    Detailed response for the listings

  - `response.listingsResponse.id` (integer)
    The id of the listing details

  - `response.listingsResponse.type` (string)
    The directory where this listing appears

  - `response.listingsResponse.typeName` (string)
    Listing type / Publisher name

  - `response.listingsResponse.listingUrl` (string)
    Listing URL

  - `response.listingsResponse.category` (string)
    The category of the directory of this listing
    Example: "social, search"

  - `response.listingsResponse.mandatoryFieldsMissing` (array)
    Mandatory field missing on the location which prevents the data to be submitted to the publisher

  - `response.listingsResponse.directorySpecificData` (object)
    Directory specific data. e.g. Google publishing states which can be UNVERIFIED, DISABLED, SUSPENDED, DUPLICATE.

  - `response.listingsResponse.directorySpecificData.requestAdminRightsUrl` (string)

  - `response.listingsResponse.directoryContactDetails` (object)
    Contact details of the publisher when the listing needs to be claimed

  - `response.listingsResponse.directoryContactDetails.email` (string)
    Email address to be used to release a claim from another provider

  - `response.listingsResponse.directoryContactDetails.website` (string)
    Contact website address to be used to release a claim from another provider

  - `response.listingsResponse.directoryConnectInfo` (object)
    Directory Connect Info model

  - `response.listingsResponse.directoryConnectInfo.status` (string)
    Listing Connect Status [CONNECTED, NOT_CONNECTED, NOT_NEEDED]
    Enum: "CONNECTED", "NOT_CONNECTED", "NOT_NEEDED"

  - `response.listingsResponse.directoryConnectInfo.userDetails` (object)
    Connect Flow User Details model

  - `response.listingsResponse.directoryConnectInfo.userDetails.name` (string)
    Connected account detail (Account name)

  - `response.listingsResponse.directoryConnectInfo.userDetails.email` (string)
    Connected account detail (email)

  - `response.listingsResponse.directoryConnectInfo.userDetails.dateConnected` (string)
    his should indicate the date that this user made the connection

  - `response.listingsResponse.directoryConnectInfo.userDetails.defaultForSalesPartner` (boolean)
    This should indicate whether the connection in place has been produced by a salesPartner level connection

  - `response.listingsResponse.directoryConnectInfo.userDetails.defaultForBusiness` (boolean)
    This should indicate whether the connection in place has been produced by a business level connection

  - `response.listingsResponse.status` (string)
    Listing Status [SYNCED, SUBMITTED, UPDATING, ACTION_REQUIRED, LINKED]
    Enum: "SYNCED", "SUBMITTED", "UPDATING", "LINKED", "ACTION_REQUIRED"

  - `response.listingsResponse.action` (string)
    Action Required [CONNECT, VERIFY, CLAIM, ADD_MANDATORY_FIELDS, ACCESS]
    Enum: "CONNECT", "VERIFY", "CLAIM", "ADD_MANDATORY_FIELDS", "ACCESS"

  - `response.firstSyncStarted` (string)
    Date & time the first sync was started on the location.

## Response 400 fields (application/json):

  - `status` (string, required)
    Enum: "SUCCESS", "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"

  - `message` (string)
    (optional) Holds further information about the response

  - `errorCode` (string)
    Enum: "NORMALIZATION_FAILED", "DATA_CORRUPTED", "INVALID_INPUT", "NOT_SYNCABLE", "PAYMENT_FAILED", "FREE_TIER_REACHED", "LIMIT_REACHED", "INACTIVE", "UNKNOWN", "IDENTIFIER_NOT_UNIQUE", "ACCOUNT_WAITING_FOR_AUTO_PAGE_SELECT", "NO_ACCOUNT_CONNECTED", "NO_PAGE_SELECTED", "PAGE_NOT_CREATED", "PAGE_IN_REVIEW", "PAGE_CLAIMED_BY_OTHERS", "OVERLAPPING_SOCIALPOST", "TOO_MANY_REPLIES", "REPLY_TOO_LONG", "DEPRECATED"

  - `response` (object)
    (optional) The actual response object of the response

## Response 401 fields (application/json):

  - `status` (string, required)
    Enum: "SUCCESS", "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"

  - `message` (string)
    (optional) Holds further information about the response

  - `errorCode` (string)
    Enum: "NORMALIZATION_FAILED", "DATA_CORRUPTED", "INVALID_INPUT", "NOT_SYNCABLE", "PAYMENT_FAILED", "FREE_TIER_REACHED", "LIMIT_REACHED", "INACTIVE", "UNKNOWN", "IDENTIFIER_NOT_UNIQUE", "ACCOUNT_WAITING_FOR_AUTO_PAGE_SELECT", "NO_ACCOUNT_CONNECTED", "NO_PAGE_SELECTED", "PAGE_NOT_CREATED", "PAGE_IN_REVIEW", "PAGE_CLAIMED_BY_OTHERS", "OVERLAPPING_SOCIALPOST", "TOO_MANY_REPLIES", "REPLY_TOO_LONG", "DEPRECATED"

  - `response` (object)
    (optional) The actual response object of the response

## Response 403 fields (application/json):

  - `status` (string, required)
    Enum: "SUCCESS", "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"

  - `message` (string)
    (optional) Holds further information about the response

  - `errorCode` (string)
    Enum: "NORMALIZATION_FAILED", "DATA_CORRUPTED", "INVALID_INPUT", "NOT_SYNCABLE", "PAYMENT_FAILED", "FREE_TIER_REACHED", "LIMIT_REACHED", "INACTIVE", "UNKNOWN", "IDENTIFIER_NOT_UNIQUE", "ACCOUNT_WAITING_FOR_AUTO_PAGE_SELECT", "NO_ACCOUNT_CONNECTED", "NO_PAGE_SELECTED", "PAGE_NOT_CREATED", "PAGE_IN_REVIEW", "PAGE_CLAIMED_BY_OTHERS", "OVERLAPPING_SOCIALPOST", "TOO_MANY_REPLIES", "REPLY_TOO_LONG", "DEPRECATED"

  - `response` (object)
    (optional) The actual response object of the response

## Response 404 fields (application/json):

  - `status` (string, required)
    Enum: "SUCCESS", "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"

  - `message` (string)
    (optional) Holds further information about the response

  - `errorCode` (string)
    Enum: "NORMALIZATION_FAILED", "DATA_CORRUPTED", "INVALID_INPUT", "NOT_SYNCABLE", "PAYMENT_FAILED", "FREE_TIER_REACHED", "LIMIT_REACHED", "INACTIVE", "UNKNOWN", "IDENTIFIER_NOT_UNIQUE", "ACCOUNT_WAITING_FOR_AUTO_PAGE_SELECT", "NO_ACCOUNT_CONNECTED", "NO_PAGE_SELECTED", "PAGE_NOT_CREATED", "PAGE_IN_REVIEW", "PAGE_CLAIMED_BY_OTHERS", "OVERLAPPING_SOCIALPOST", "TOO_MANY_REPLIES", "REPLY_TOO_LONG", "DEPRECATED"

  - `response` (object)
    (optional) The actual response object of the response