---
title: "Get listings health"
method: GET
path: "/dashboard/listing-health"
tags: ["Dashboard"]
---

# Get listings health

`GET /dashboard/listing-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).

## Query parameters

- `v` unknown
- `filterCategory` 'location' | 'business' | 'labels' | 'location-groups'
- `locationIds` unknown
- `businessIds` unknown
- `labels` unknown
- `locationGroupIds` unknown
- `excludedLocationIds` unknown
- `excludedBusinessIds` unknown
- `excludedLabels` unknown
- `excludedLocationGroupIds` unknown

## Response `200`

Listings health status breakdown. Versions older than 20260713 additionally include directoriesMissingConnect, countLocationsNeedsReview and countFieldsInSync.

- union
  - object — Listing sync status breakdown across all directories
    - `countListingsInSync` unknown, required
    - `countListingsBeingUpdated` unknown, required
    - `countListingsLinked` unknown, required
    - `countListingsSubmitted` unknown, required
    - `countListingsActionRequired` unknown, required
    - `countLocationsRequireSync` unknown, required
    - `totalListings` unknown, required
  - object — Legacy listings health response. Returned for API versions older than 20260713, restoring the directoriesMissingConnect, countLocationsNeedsReview and countFieldsInSync fields for backwards compatibility.
    - `countListingsInSync` unknown, required
    - `countListingsBeingUpdated` unknown, required
    - `countListingsLinked` unknown, required
    - `countListingsSubmitted` unknown, required
    - `countListingsActionRequired` unknown, required
    - `countLocationsRequireSync` unknown, required
    - `totalListings` unknown, required
    - `directoriesMissingConnect` unknown[], required — Directory types (GOOGLE, FACEBOOK) with at least one unconnected location
      - unknown
    - `countLocationsNeedsReview` unknown, required
    - `countFieldsInSync` unknown, required

---

[API](https://skmtc.net/uberall/apis/uberall-api.md) · [All operations](https://skmtc.net/uberall/apis/uberall-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uberall/uberall-api/revisions/a506e82d7cbe/schema)