# Get listings health

Retrieves the current listing sync status breakdown across all directories for filtered locations. Counts listings by status: in sync, being updated, linked, submitted, action required, and locations requiring sync. Reflects current state (no date range).

Endpoint: GET /dashboard/listing-health
Version: 20260701

## Query parameters:

  - `v` (any)
    API version. Defaults to the latest version. Versions older than 20260713 additionally return the legacy directoriesMissingConnect, countLocationsNeedsReview and countFieldsInSync fields.

  - `filterCategory` (string)
    Filter strategy to use for scoping locations

  - `locationIds` (any)
    Comma-separated location IDs (used when filterCategory=location)

  - `businessIds` (any)
    Comma-separated business IDs (used when filterCategory=business)

  - `labels` (any)
    Label names (used when filterCategory=labels)

  - `locationGroupIds` (any)
    Location group IDs (used when filterCategory=location-groups)

  - `excludedLocationIds` (any)
    Comma-separated location IDs to exclude from results

  - `excludedBusinessIds` (any)
    Comma-separated business IDs to exclude from results

  - `excludedLabels` (any)
    Label names to exclude from results

  - `excludedLocationGroupIds` (any)
    Location group IDs to exclude from results

## Response 200 fields (application/json):

  - `countListingsInSync` (any, required)
    Number of listings fully in sync

  - `countListingsBeingUpdated` (any, required)
    Number of listings currently being updated

  - `countListingsLinked` (any, required)
    Number of listings linked to directories

  - `countListingsSubmitted` (any, required)
    Number of listings submitted to directories

  - `countListingsActionRequired` (any, required)
    Number of listings requiring manual action

  - `countLocationsRequireSync` (any, required)
    Number of locations that require a sync

  - `totalListings` (any, required)
    Total number of listings across all directories

  - `countListingsInSync` (any, required)

  - `countListingsBeingUpdated` (any, required)

  - `countListingsLinked` (any, required)

  - `countListingsSubmitted` (any, required)

  - `countListingsActionRequired` (any, required)

  - `countLocationsRequireSync` (any, required)

  - `totalListings` (any, required)

  - `directoriesMissingConnect` (array, required)
    Directory types (GOOGLE, FACEBOOK) with at least one unconnected location

  - `countLocationsNeedsReview` (any, required)
    Number of locations with faulty data (failed normalization or invalid cleansing) in need of review

  - `countFieldsInSync` (any, required)
    Number of directory fields currently in sync, summed across all directories