Leads

List referrals

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.

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

Query parameters

statusstring[]

Filter by referral status. Repeatable (?status[]=open&status[]=accepted).

slugsstring[]

Filter to specific Lasso Lead Keys. Repeatable.

partner_slugstring
partner_idstring
partner_type_slugstring
partner_type_idstring
segment_slugstring

Filter by reward plan slug.

segment_idstring

Filter by reward plan ID.

tier_slugstring
managed_by_emailstring email
managed_by_idstring
revenue_source_idstring
created_fromstring date

Start of a created-at range (ISO 8601 date). Must be sent with created_to.

created_tostring date

End of a created-at range (ISO 8601 date). Must be sent with created_from.

updated_fromstring date

Start of a last-updated range (ISO 8601 date). Must be sent with updated_to. Both bounds are inclusive whole days in your account's timezone: the range runs from the start of updated_from to the end of updated_to in that timezone, not in UTC.

Use it to pick up referrals changed since your last sync. Because the bounds are whole days, re-read from the day of your last sync rather than the day after, and de-duplicate on the referral's slug (its Lasso Lead Key). It tracks changes saved on the referral itself, such as its status, amount, expiry and notes. Changes kept on related records, such as the prospect's contact details, rewards, invoices and revenue items, do not move it.

updated_tostring date

End of a last-updated range (ISO 8601 date), inclusive through the end of that day in your account's timezone. Must be sent with updated_from.

expires_fromstring date

Start of an expiry range. Must be sent with expires_to.

expires_tostring date

End of an expiry range. Must be sent with expires_from.

hubspot_deal_idstring

Find the referral carrying this CRM record ID. The same works with hubspot_contact_id, hubspot_company_id, salesforce_opportunity_id, salesforce_account_id, salesforce_lead_id, salesforce_contact_id, salesforce_custom_referral_object_id, pipedrive_organization_id, pipedrive_person_id and pipedrive_deal_id. Send one: if several are sent, only the first in that order is used.

sortstring

Sort column and direction separated by __, e.g. created_at__desc. Columns: created_at, expires_at, name (company, then contact name). Direction: asc or desc.

pageinteger
per_pageinteger

Values above 100 are treated as 100.

Response

List of referrals

pageinteger
per_pageinteger
total_countinteger
total_pagesinteger

Example response

{
  "leads": [
    {
      "slug": "abc-123",
      "source_type": "referral_link",
      "company_name": "Lead Company",
      "contact_name": "Jane Doe",
      "email": "jane@leadco.com",
      "partner_slug": "acme-corp",
      "partner_lasso_key": "P-A1B2C3",
      "partner_member": {
        "slug": "PC-A1B2C3"
      },
      "currency_code": "USD",
      "billing_start_date": "2026-10-01"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.