---
title: "Find colleagues at a company"
method: POST
path: "/api/v1/contacts/lookup/colleagues"
tags: ["Lookup"]
---

# Find colleagues at a company

`POST /api/v1/contacts/lookup/colleagues`

## Request

- Base URL: `https://app.getleads.io`
- URL: `https://app.getleads.io/api/v1/contacts/lookup/colleagues`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Returns contacts at the same company, identified by email domain or
LinkedIn company URL. 1 credit per contact returned.

## Request body

- object
  - `email_domain` string: Work email domain (e.g. acme.com). Mutually exclusive with linkedin_company_url.
  - `linkedin_company_url` string: LinkedIn company URL. Mutually exclusive with email_domain.
  - `job_titles` string[]: Optional title filter.
  - `limit_per_item` integer
  - `offset` integer

## Response `200`

Colleague results

- object
  - `ok` boolean
  - `contacts` Contact[]
  - `total_available` integer
  - `query_credits_used` integer
  - `creditsRemaining` integer, nullable
  - `offset` integer
  - `limit` integer
  - `returned` integer
  - `has_more` boolean
  - `next_offset` integer
  - `credits_exhausted` boolean
  - `message` string
  - `code` string
  - `normalized_inputs` object

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key
- `402`: Insufficient credits or fair-use limit reached

---

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