---
title: "List All Prospects"
method: GET
path: "/provider/prospects"
tags: ["Prospect"]
---

# List All Prospects

`GET /provider/prospects`

## Request

- Base URL: `https://api.sandbox.hint.com/api`
- URL: `https://api.sandbox.hint.com/api/provider/prospects`
- Auth: API key in header `AUTHORIZATION`

## Query parameters

- `limit` integer
- `offset` integer
- `status` string
- `updated_at` string, date-time
- `created_at` string, date-time

## Response `200`

Successful response

- PublicProspectBlueprintAll[]
  - object[]
    - `id` string
    - `address_city` string
    - `address_country` string
    - `address_line1` string
    - `address_line2` string
    - `address_state` string
    - `address_zip` string
    - `created_at` string, date-time
    - `dob` string, date
    - `email` string
    - `email_marketing_authorization` 'opted_in' | 'opted_out': Marketing consent recorded for this record's email address: `opted_in` (explicit opt-in), `opted_out` (explicit opt-out), or `null` when none has been recorded. `null` is not an opt-out — marketing email is permitted unless `opted_out`. Set it with Set Communication Authorization; it is read-only here.
    - `first_name` string
    - `last_name` string
    - `lead_source_other` string
    - `phone` string
    - `status` string
    - `updated_at` string, date-time
    - `lead_source` PublicLeadSourceBlueprintLeaf
      - `id` string
      - `name` string
    - `location` PublicLocationBlueprintMin
      - `id` string
      - `name` string
    - `patient` PublicPatientBlueprintMin
      - `id` string
      - `name` string
    - `plan` PublicPlanBlueprintMin
      - `id` string
      - `name` string
      - `plan_type` string
    - `practitioner` PublicPractitionerBlueprintMin
      - `id` string
      - `name` string

## Changes

- **2026-11-03** `c9bda0d2dd87`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hint/apis/partner-endpoints/changes/provider/prospects/get.md)

---

[API](https://skmtc.dev/hint/apis/partner-endpoints.md) - [All operations](https://skmtc.dev/hint/apis/partner-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/hint/apis/partner-endpoints/revisions/c9bda0d2dd87?raw)