---
title: "Get Market Leads Dashboard"
method: GET
path: "/market-leads"
tags: ["market-leads"]
---

# Get Market Leads Dashboard

`GET /market-leads`

## Query parameters

- `status` string, nullable
- `source_key` string, nullable
- `search` string, nullable
- `limit` integer

## Response `200`

Successful Response

- MarketLeadsDashboardResponse
  - `kpis` MarketLeadKpis, required
    - `total` integer, required
    - `contacted` integer, required
    - `replied` integer, required
    - `qualified` integer, required
    - `jobs_created` integer, required
    - `won` integer, required
    - `response_rate` number, required
    - `qualified_rate` number, required
    - `avg_speed_to_lead_seconds` number, nullable
    - `median_speed_to_lead_seconds` number, nullable
    - `conversion_rate` number
    - `active_pipeline` integer
    - `total_revenue` number
    - `avg_deal_size` number
    - `revenue_by_month` MarketLeadRevenueByMonth[]
      - `month` string, required
      - `count` integer, required
      - `revenue` number, required
      - `is_current_month` boolean, required
  - `sources` MarketLeadSourcePerformance[], required
    - `source_key` string, required
    - `source_display_name` string, nullable
    - `total` integer, required
    - `contacted` integer, required
    - `replied` integer, required
    - `qualified` integer, required
    - `won` integer, required
    - `reply_rate` number, required
    - `conversion_rate` number, required
    - `active_pipeline` integer, required
    - `median_speed_to_lead_seconds` number, nullable
    - `qualified_rate` number, required
  - `comfort_advisors` MarketLeadComfortAdvisorPerformance[]
    - `comfort_advisor_id` string, nullable
    - `comfort_advisor_name` string, required
    - `won` integer, required
    - `total_contacted` integer
    - `revenue` number, required
    - `conversion_rate` number, required
    - `reply_rate` number, required
    - `median_speed_to_lead_seconds` number, nullable
    - `active_pipeline` integer
    - `jobs` MarketLeadWonJob[]
      - `market_lead_id` string, required
      - `customer_name` string, nullable
      - `job_id` string, nullable
      - `job_completion_date` string, nullable
      - `estimate_sold_date` string, nullable
      - `won_amount` number, nullable
  - `leads` MarketLeadSummary[], required
    - `id` string, required
    - `source_key` string, required
    - `source_display_name` string, nullable
    - `customer_name` string, nullable
    - `phone` string, nullable
    - `email` string, nullable
    - `primary_contact_method` string, required
    - `preferred_contact_method` string, required
    - `status` string, required
    - `qualification_status` string, required
    - `service_category` string, nullable
    - `project_details` string, nullable
    - `ai_paused` boolean
    - `needs_office` boolean
    - `st_job_id` union
      - integer
      - string
    - `st_booking_status` string, nullable
    - `st_booking_started_at` string, date-time, nullable
    - `st_booking_error` string, nullable
    - `backoffice_notification_status` string, nullable
    - `first_contacted_at` string, date-time, nullable
    - `last_message_at` string, date-time, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
  - `sender_config` MarketLeadSenderConfig, required
    - `sms_sender_user_id` string, nullable
    - `email_sender_user_id` string, nullable
    - `email_sender_address` string, nullable
    - `sms_sender_name` string, nullable
    - `sms_sender_phone` string, nullable
    - `email_sender_name` string, nullable
    - `email_sender_status` string, nullable
    - `st_job_alert_to_number` string, nullable
    - `notification_recipients` string[]
    - `market_leads_enabled` boolean
    - `ballpark_pricing_enabled` boolean

## Other responses

- `404` — Not found
- `422` — Validation Error

---

[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.dev/noso/apis/crucible-backend-api/revisions/6242f8ed3b67?raw)