---
title: "List a partner's contacts"
method: GET
path: "/partners/{identifier}/contacts"
tags: ["Partner Contacts"]
---

# List a partner's contacts

`GET /partners/{identifier}/contacts`

## Request

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

Lists the active contacts at one partner, oldest first. Requires `partners_read` permission.

Filter by `email` or by a CRM contact ID to check whether a contact already exists before
you write. Filters combine, so sending two narrows the result to contacts matching both.

## Path parameters

- `identifier` string, required

## Query parameters

- `by` 'slug' | 'id' | 'lasso_key' | 'name' | 'external'
- `external_system_type` string
- `external_object_type` string
- `email` string, email
- `hubspot_contact_id` string
- `salesforce_contact_id` string
- `pipedrive_person_id` string
- `page` integer
- `per_page` integer

## Response `200`

The partner's contacts

- PartnerContactListResponse
  - `contacts` PartnerContact[]
    - `slug` string: The contact's Lasso key. Use it to address the contact in the path.
    - `partner_slug` string
    - `name` string, nullable
    - `email` string, nullable
    - `phone_number` string, nullable
    - `title` string, nullable
    - `linkedin_url` string, nullable
    - `role` string, nullable: The contact's role at the partner, which decides what they can see and do in the partner portal.
    - `status` 'active' | 'deleted'
    - `external_ids` ExternalId[]: CRM records linked to this contact.
      - `system_type` string, required: e.g. HUBSPOT, SALESFORCE, PIPEDRIVE
      - `object_type` string, required: e.g. company, contact, deal, opportunity, account
      - `identifier` string, required
    - `created_at` string, date-time
    - `updated_at` string, date-time
  - `page` integer
  - `per_page` integer
  - `total_count` integer
  - `total_pages` integer

## Other responses

- `401`: Missing or invalid API key
- `403`: API key lacks required permission
- `404`: Resource not found
- `422`: The partner lookup was ambiguous (`?by=name` matched more than one partner) or incomplete (`?by=external` without `external_object_type`, for a system other than Salesforce)
- `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)