> ## Documentation index
> Fetch the complete documentation index at: https://leadmcp.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Find colleagues at a company

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

Authentication: API key.

Find people at a company from its email domain (e.g. `acme.com`) **or** its company profile URL, pass `email_domain` or `linkedin_company_url`, not both. Optional `job_titles` narrows to matching titles (same whole-word token match as search `job_titles`; omit to return everyone). Queries the LeadMCP contact database, same data as search. Defaults to verified emails only. Returns contacts with pagination (`has_more`, `next_offset`). One credit per record returned; 0 if none. Default `limit_per_item` 100 (max 5000). For very large lists, use search export with the same domain filter. MCP tool: `leadmcp_lookup_colleagues`.

### Body parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `email_domain` | string | no |  |  |
| `job_titles` | array | no |  |  |
| `limit_per_item` | number | no |  |  |
| `offset` | number | no |  |  |

### Response fields

| Field | Type | Description |
| --- | --- | --- |
| `ok` | boolean | True when the request succeeded. |
| `contacts` | array | The contact records for this page. |
| `total_available` | number | A pagination hint. Use the count endpoint for the exact total. |
| `query_credits_used` | number | Plan credits this request spent. |
| `creditsRemaining` | number | Plan credits left after this request. Null on unlimited plans. |
| `offset` | number | The row offset this page started at. |
| `limit` | number | The number of rows this page requested. |
| `returned` | number | The number of rows this page returned. |
| `has_more` | boolean | True when more rows are available. |
| `next_offset` | number | Pass this as offset to read the next page. |
| `normalized_inputs` | object | The inputs after LeadMCP cleaned them up. |

### Example request

```bash
curl -sS -X POST "https://leadmcp.ai/api/v1/contacts/lookup/colleagues" \
  -H "X-API-Key: lb_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email_domain":"tabby.ai","limit_per_item":100}'
```

### Example response (200)

```json
{
  "ok": true,
  "contacts": [ "..." ],
  "total_available": 842,
  "query_credits_used": 100,
  "creditsRemaining": 4900,
  "offset": 0,
  "limit": 100,
  "returned": 100,
  "has_more": true,
  "next_offset": 100,
  "normalized_inputs": { "email_domain": "tabby.ai" }
}
```