---
title: "Get Lead Settings"
method: GET
path: "/settings/leads"
tags: ["Settings"]
---

# Get Lead Settings

`GET /settings/leads`

Get lead notification settings for the customer.

Returns lead notification settings including dry run mode and email recipients.
If no settings exist, returns defaults (dry_run=True, empty recipients).

## Response `200`

Successful Response

- LeadSettingsResponse — Lead notification settings response model
  - `email_notifications_enabled` boolean, required — Whether automatic lead notification emails are enabled
  - `dry_run` boolean, required — Whether lead notification emails require manual sending
  - `notification_email_recipients` string[] — List of email addresses to receive lead notification emails
  - `sms_notifications_enabled` boolean, required — Whether automatic lead notification SMS are enabled
  - `notification_sms_recipients` string[] — List of phone numbers (E.164 format) to receive lead notification SMS
  - `lead_scoring_context` string, nullable — Criteria for scoring leads as low, medium, or high value
  - `lead_scoring_mode` 'low_medium_high' | 'custom_prompt' — Which lead scoring strategy to use
  - `lead_scoring_custom_prompt` string, nullable — Free-text scoring instructions used when lead_scoring_mode is 'custom_prompt'
  - `lead_scoring_custom_schema` object, nullable — JSON Schema (draft-7 object) describing the custom scoring output when lead_scoring_mode is 'custom_prompt'
  - `test_notifications_enabled` boolean, required — Whether notifications are sent for test calls and chats
  - `lead_source_enabled` boolean, required — Whether lead source extraction is enabled for calls and chats
  - `lead_generation_context` string, nullable — General context to guide lead classification and extraction behavior
  - `info_request_forces_lead` boolean, required — Whether sending an info request SMS during a call forces the call to be classified as a lead
  - `lead_notification_template` 'default' | 'legal_pocket' | 'credit_hound' — Which SES email template variant to use for lead notifications
  - `lead_value_label` 'lead_value' | 'lead_priority' | 'lead_score' — Which label to display for the lead score metric (app UI, emails, SMS)

---

[API](https://skmtc.dev/openintake/apis/fastapi.md) · [All operations](https://skmtc.dev/openintake/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintake/fastapi/revisions/4a81645b59f6/schema)