loading…

Find Employees API | Captain Data

▸ readmecat find-employees.md

Find Employees

List employees at a company — name, job title, location, and LinkedIn profile URL.

GET

method

1 / req + 1 / result

cost

Start free Run it here

▸ sessionGET /v1/companies/{uid}/employees

captaindata — sessionlive · sample responses from real endpointsready

$ curl GET /v1/companies/{uid}/employees

?uid=

examples

Pick an example above, or edit the argument and press r
to list employees.

LIVEGET /v1/companies/{uid}/employeesuptime 99%

What is the Find Employees API?

The Find Employees API returns the people working at a given company (by company UID) as structured JSON with pagination — useful for mapping an account's org or building a contact list for a target company.

How it works

Provide a company UID (from Company Search or Company Enrichment) and get its employees back, metered in credits. Combine with People Enrichment to hydrate any employee into a full profile.

What you can build

Map an account's org

Pull the people at a target company to understand its structure.

Build contact lists for accounts

Generate a list of relevant people at each target company for outreach.

Find decision-makers

Surface the roles that matter at an account, then enrich them.

Power ABM playbooks

Feed account-based plays with the right contacts per company.

§ 01 · FIELDS — each employee in the /companies/{uid}/employees array

fieldtypereq.description

uidstringyesCaptain Data stable identifier.

full_namestringyesFull display name.

first_namestringyesGiven name.

last_namestringyesFamily name.

company_namestringyesCompany name.

job_titlestringyesRole at the company.

summarystring | nullnoAbout section text.

locationstringyesResolved location.

profile_image_urlstringnoProfile photo URL.

li_profile_urlstringyesCanonical LinkedIn profile URL.

li_profile_idnumberyesLinkedIn numeric profile id.

sn_company_idnumbernoSales Navigator company id.

tenure_startstringnoRole start date at the company.

tenure_endstringnoRole end date, when known.

tenure_lengthstringnoHuman-readable tenure.

recently_hiredbooleannoJoined in the last 90 days.

recently_promotedbooleannoPromoted in the last 90 days.

§ 02 · RELATED ENDPOINTS — one API, seven calls

all products →

GET

People Enrichment

Get comprehensive profile information from a LinkedIn profile URL.

1 creditView →

GET

Find People

Find people by full name and optional company name.

2 creditsView →

GET

People Search

Search and discover people based on a search query.

1 / req + 1 / resultView →

GET

Company Enrichment

Get comprehensive company information from a LinkedIn URL or domain — full firmographics in one call.

1 creditView →

§ 03 · FAQ — common questions

QWhat data is returned for each employee?›

Find Employees returns each employee's name, job title, company, location, and LinkedIn profile URL/id. For the full experiences/education schema, enrich individual profiles with People Enrichment.

QCan I filter employees by role or department?›

Yes! You can filter by job title keywords, seniority level, and department. This helps you find specific decision-makers or build targeted prospect lists within a company.

QHow many employees can I retrieve per company?›

You can retrieve up to 2,500 employees per company. For larger organizations, use pagination to access the complete employee list.

QWhat is the pricing for Find Employees?›

Find Employees costs 1 credit base fee plus 1 credit per employee returned. Retrieving 50 employees would cost 11 credits (1 + 50 × 0.2).

Ship find employees today.

Grab an API key in 30 seconds. No credit card, 100-credit free trial.

Start free API docs