---
title: "List referrals"
method: GET
path: "/leads"
tags: ["Leads"]
---

# List referrals

`GET /leads`

## Request

- Base URL: `https://api.lassotech.com/api/v1/rest`
- URL: `https://api.lassotech.com/api/v1/rest/leads`
- Auth: API key in header `x-lasso-access-token`

List referrals in your account, oldest first by default. Requires `partners_read`.

Deleted referrals are excluded. Results are paginated and stably ordered, so walking
`page=1..n` visits every referral exactly once even when many share a `created_at`.

List filters take repeated values (`?status[]=open&status[]=accepted`); a single bare value is
read as a one-item list. A `*_slug` or `managed_by_email` filter that matches nothing returns no
referrals rather than ignoring the filter. Date ranges are inclusive and both ends are required.

## Query parameters

- `status` string[]
- `slugs` string[]
- `partner_slug` string
- `partner_id` string
- `partner_type_slug` string
- `partner_type_id` string
- `segment_slug` string
- `segment_id` string
- `tier_slug` string
- `managed_by_email` string, email
- `managed_by_id` string
- `revenue_source_id` string
- `created_from` string, date
- `created_to` string, date
- `updated_from` string, date
- `updated_to` string, date
- `expires_from` string, date
- `expires_to` string, date
- `hubspot_deal_id` string
- `sort` string
- `page` integer
- `per_page` integer

## Response `200`

List of referrals

- object
  - `leads` Lead[]
    - `slug` string
    - `status` 'open' | 'accepted' | 'qualified' | 'closed_won' | 'closed_lost' | 'rejected' | 'churned' | 'expired'
    - `source_type` string, nullable
    - `company_name` string, nullable
    - `contact_name` string, nullable
    - `email` string, nullable
    - `partner_slug` string, nullable
    - `partner_lasso_key` string, nullable: The partner's Lasso Partner Key, the value to send back as `partner_lasso_key`.
    - `partner_member` object, nullable: The partner contact this referral is attributed to, if any.
      - `slug` string
      - `full_name` string, nullable
      - `email` string, nullable
    - `rewards` object[]: The rewards copied onto this referral from the partner's plan. Empty until the referral is accepted. `payee_type` says who each reward is owed to, so you can confirm a partner-contact reward actually landed rather than being skipped for want of a contact.
      - `name` string, nullable
      - `reward_type` string
      - `amount` string
      - `amount_type` string
      - `currency` string
      - `payee_type` 'partner' | 'partner_user'
    - `amount` string: Deal amount.
    - `currency_code` string
    - `expected_close_date` string, date, nullable
    - `co_sold` boolean
    - `deleted_at` string, date-time, nullable
    - `expires_at` string, date-time, nullable
    - `billing_start_date` string, date: The date this referral's billing starts from, after any override is applied.
    - `billing_start_date_override` string, date, nullable: The override set with `billing_start_date` on update, or null when the date is derived from your billing settings.
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `page` integer
  - `per_page` integer
  - `total_count` integer
  - `total_pages` integer

## Other responses

- `400`: Malformed or unsupported parameter
- `401`: Missing or invalid API key
- `403`: API key lacks required permission
- `429`: Rate limit exceeded. Wait the number of seconds in `Retry-After`, then retry.

---

[API](https://skmtc.dev/onelasso/apis/lasso-rest-api.md) · [All operations](https://skmtc.dev/onelasso/apis/lasso-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/onelasso/apis/lasso-rest-api/revisions/bbc328f5e2d1?raw)