---
title: "List/search partners"
method: GET
path: "/partners"
tags: ["Partners"]
---

# List/search partners

`GET /partners`

## Request

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

Lists partners with optional filters, sorting, and pagination, oldest first by default.
Deleted partners and merged duplicates are not listed. Requires `partners_read` permission.

List filters take repeated values (`?tags[]=gold&tags[]=silver`); a single bare value
(`?tags=gold`) is read as a one-item list. A `*_slug` or `managed_by_email` filter that
matches nothing returns no partners rather than ignoring the filter.

`certification_ids` was renamed to `badge_ids`; sending the old name is a `400` rather than
being ignored.

## Query parameters

- `partner_type_id` string
- `partner_type_ids` string[]
- `segment_id` string
- `tier_id` string
- `tier_ids` string[]
- `managed_by_id` string
- `managed_by_email` string
- `health_band_label` string
- `partner_type_slug` string
- `segment_slug` string
- `tier_slug` string
- `receiving_revenue_share` boolean
- `activated` 'activated' | 'not_activated'
- `tags` string[]
- `regions` string[]
- `search` string
- `directory_listing_status` string[]
- `directory_visibility` string[]
- `integration_type` string[]
- `badge_ids` string[]
- `directory_filter_selections` object[]
  - `filter_key_id` string
  - `selected_option_ids` string[]
- `course_slug` string
- `course_completion_status` 'completed' | 'not_completed' | 'not_enrolled'
- `sort` string
- `page` integer
- `per_page` integer

## Response `200`

List of partners

- PartnerListResponse
  - `partners` Partner[]
    - `slug` string
    - `name` string
    - `crm_identifier` string
    - `website_url` string, nullable
    - `linkedin_url` string, nullable
    - `status` 'active' | 'deleted'
    - `partner_type` string, nullable
    - `segment` string, nullable
    - `managed_by` string, nullable: Email of the managing user
    - `payment_terms` 'due_on_invoice' | 'net_10' | 'net_15' | 'net_30' | 'net_45' | 'net_60' | 'net_90' | 'end_of_month', nullable
    - `payment_frequency` 'monthly' | 'quarterly' | 'semi_annually' | 'yearly', nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `page` integer
  - `per_page` integer
  - `total_count` integer
  - `total_pages` integer

## Other responses

- `400`: A filter was malformed, or `certification_ids` was sent
- `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)