---
title: "List Referral Partners"
method: GET
path: "/referrals/partners"
tags: ["Referrals"]
---

# List Referral Partners

`GET /referrals/partners`

## Request

- Base URL: `https://api.openintake.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.openintake.ai/referrals/partners`
- Auth: none declared

## Response `200`

Successful Response

- ReferralPartnerListResponse
  - `partners` ReferralPartnerResponse[], required
    - `referral_partner_id` string, uuid, required
    - `name` string, required
    - `firm_name` string, nullable
    - `email` string, nullable
    - `phone_number` string, nullable
    - `has_login` boolean, required: Whether a portal login exists for this partner
    - `login_kind` 'partner' | 'firm_user', nullable: partner = a portal-only account; firm_user = one of the firm's own users
    - `sa_contact_id` integer, nullable
    - `sa_attorney_contact_id` integer, nullable
    - `referral_source_kind` 'attorney' | 'other' | 'paid', nullable
    - `case_contact_role` string, nullable
    - `intake_performed_by` string, nullable
    - `test_account` boolean: Its referrals never reach SmartAdvocate (always a dry run)
    - `is_active` boolean, required
    - `referral_count` integer
    - `created_at` string, date-time, required
    - `set_password_link` string, nullable: Only returned when a developer invited with skip_invite_email; must be delivered to the partner out of band.

## Changes

- **2026-10-21** `62b223e8ec22`: 1 info
  - added the optional property `partners/items/test_account` to the response with the `200` status
- **2026-10-16** `4ceb1e8613ee`: 1 info
  - added the optional property `partners/items/login_kind` to the response with the `200` status
- **2026-10-16** `b3a39dc007df`: 1 warning, 4 info
  - removed the optional property `partners/items/sa_firm_contact_id` from the response with the `200` status
  - added the optional property `partners/items/case_contact_role` to the response with the `200` status
  - added the optional property `partners/items/intake_performed_by` to the response with the `200` status
  - added the optional property `partners/items/referral_source_kind` to the response with the `200` status
  - …1 more
- **2026-10-16** `47c26f79c0d8`: 2 info
  - added the optional property `partners/items/sa_attorney_contact_id` to the response with the `200` status
  - added the optional property `partners/items/sa_firm_contact_id` to the response with the `200` status
- **2026-09-17** `0afcd7c31ce2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/openintake/apis/openintake-api/changes/referrals/partners/get.md)

---

[API](https://skmtc.dev/openintake/apis/openintake-api.md) - [All operations](https://skmtc.dev/openintake/apis/openintake-api/llms.txt) - [OpenAPI document](https://skmtc.dev/openintake/apis/openintake-api/revisions/de90a8dcbc07?raw)