---
title: "Partner Lead"
method: GET
path: "/v1/report/lead"
tags: ["Reporting"]
---

# Partner Lead

`GET /v1/report/lead`

List the leads you've referred, newest first.

Each lead includes the contact, the properties quoted, and the Steadily agent who is assisting that lead.

Lead statuses indicate how that lead performed:
- New - Newly created leads.
- Converted - Leads that convert and buy a policy.
- Unqualified - Leads that ultimately did not convert.
- Awaiting quote - Leads that are currently being quoted, pending customer decision or underwriting review.

Account-level reporting also provides a contacted status to indicate whether we've successfully established contact with that customer.

Results are paginated; follow next_url for the next page.

## Query parameters

- `limit` integer
- `starting_after_id` string, nullable
- `order_by` '-created_timestamp' | 'created_timestamp' | '-updated_timestamp' | 'updated_timestamp'
- `created_after` string, date-time, nullable
- `created_before` string, date-time, nullable
- `updated_after` string, date-time, nullable
- `updated_before` string, date-time, nullable
- `status` 'converted' | 'unqualified' | 'awaiting_quote' | 'new'

## Response `200`

Successful Response

- LeadListPage
  - `leads` Lead[], required
    - `lead_id` string, required
    - `first_name` string
    - `last_name` string
    - `account_id` string
    - `external_record_id` string
    - `created_at_timestamp` string, date-time, required
    - `updated_at_timestamp` string, date-time, required
    - `referral_code` string
    - `status` 'converted' | 'unqualified' | 'awaiting_quote' | 'new', required — An enumeration.
    - `record_type` 'landlord' | 'renter' | 'homeowner', required — An enumeration.
    - `contact` RalphieModelsReportContact, required
      - `first_name` string
      - `last_name` string
      - `suffix` string — Name suffix such as Jr or II
      - `date_of_birth` string, date
      - `phone_number` string
      - `email` string, email
      - `mailing_address` RalphieModelsReportAddress
        - `address_1` string
        - `city` string
        - `state` string
        - `zip` string
      - `self_reported_claims` OptionalSelfReportedClaims[]
        - `date_of_loss` string, date — Approximate date of the loss
        - `loss_reason` 'weather' | 'fire' | 'water_appliance' | 'water' | 'theft' | 'earthquake' | 'liability' | 'medical' | 'other' — An enumeration.
        - `loss_amount_dollars` integer
        - `caused_by_catastrophe` 'yes' | 'no' — An enumeration.
    - `properties` LeadProperty[], required
      - `lead_property_id` string, required
      - `replacement_cost_estimate` integer
      - `address` RalphieModelsReportAddress, required
        - `address_1` string
        - `city` string
        - `state` string
        - `zip` string
      - `property_details` RalphieModelsReportPropertyDetails, required
        - `year_built` integer
        - `total_sq_feet` integer
        - `property_type` string
        - `construction_type` string
        - `roof_type` string
        - `heating_sources` string[]
        - `rental_duration` string
        - `renovation_status` string
        - `intermittent_rental` string
      - `external_property_id` string
    - `agent` Agent
      - `email` string
  - `limit` integer, required
  - `next_url` string

## Other responses

- `422` — Validation Error

---

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