# Get profile completeness

Retrieves the average profile completeness score and a breakdown of locations by completeness classification (REQUIRED, BASIC, ADVANCED, BONUS, COMPLETE, OTHER) for filtered locations. Reflects current state (no date range).

Endpoint: GET /dashboard/profile-completeness
Version: 20260701

## Query parameters:

  - `v` (any)
    API version. Defaults to the latest version. Versions older than 20191203 additionally return missingFields, directoriesMissingConnect and isLegacy.

  - `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):

  - `averageProfileCompleteness` (any, required)
    Average profile completeness percentage (0-100)
    Example: 82

  - `countLocationsMissingData` (any, required)
    Number of locations with missing data

  - `missingFields` (array, required)
    Directory fields missing on at least one of the matched locations

  - `directoriesMissingConnect` (array, required)
    Directories missing a connect on at least one of the matched locations (FACEBOOK, GOOGLE)

  - `isLegacy` (any, required)
    Always true; signals the legacy response format to pre-20191203 clients