---
title: "Get Customer Overview"
method: GET
path: "/customer-profiles/overview"
tags: ["customer-profiles"]
---

# Get Customer Overview

`GET /customer-profiles/overview`

Return customer-base overview aggregates for the Customers landing page.

## Response `200`

Successful Response

- CustomerOverviewResponse
  - `kpis` CustomerOverviewKpis
    - `total_customers` integer
    - `active_members` integer
    - `mapped_customers` integer
    - `at_risk_customers` integer
    - `due_for_reengagement` integer
    - `recently_serviced_30d` integer
    - `total_revenue` number
    - `avg_revenue_per_customer` number
  - `map_points` CustomerOverviewMapPoint[]
    - `st_customer_id` integer, required
    - `customer_name` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `latitude` number, required
    - `longitude` number, required
    - `total_revenue` number
    - `total_jobs_count` integer
    - `has_active_membership` boolean
    - `risk_level` string
    - `days_since_last_service` integer, nullable
  - `city_clusters` CustomerOverviewCityCluster[]
    - `city` string, required
    - `state` string, required
    - `customer_count` integer
    - `active_members` integer
    - `at_risk_count` integer
    - `total_revenue` number
  - `membership_types` CustomerOverviewCountItem[]
    - `label` string, required
    - `count` integer
  - `risk_buckets` CustomerOverviewCountItem[]
    - `label` string, required
    - `count` integer
  - `service_recency_buckets` CustomerOverviewCountItem[]
    - `label` string, required
    - `count` integer
  - `top_customers` CustomerOverviewCustomerRow[]
    - `st_customer_id` integer, required
    - `customer_name` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `total_revenue` number
    - `total_jobs_count` integer
    - `has_active_membership` boolean
    - `risk_level` string
    - `days_since_last_service` integer, nullable
    - `last_job_date` string, nullable
  - `watchlist` CustomerOverviewWatchRow[]
    - `st_customer_id` integer, required
    - `customer_name` string, nullable
    - `city` string, nullable
    - `state` string, nullable
    - `total_revenue` number
    - `total_jobs_count` integer
    - `has_active_membership` boolean
    - `risk_level` string
    - `days_since_last_service` integer, nullable
    - `last_job_date` string, nullable
    - `services_last_12_months` integer
    - `primary_reason` string

---

[API](https://skmtc.dev/noso/apis/crucible-backend-api.md) · [All operations](https://skmtc.dev/noso/apis/crucible-backend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/noso/crucible-backend-api/revisions/d96feef8e2ef/schema)