Contacts lookup

Find colleagues at a company

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.

POST/api/v1/contacts/lookup/colleagues

Authorization

HeaderTypeRequiredDescription
X-API-KeystringrequiredYour API key, for example lb_live_YOUR_API_KEY. You can send the same key as Authorization: Bearer instead.

Body parameters

NameTypeRequiredDefaultDescription
email_domainstringoptional
job_titlesarrayoptional
limit_per_itemnumberoptional
offsetnumberoptional

Response

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.