> ## Documentation Index > Fetch the complete documentation index at: https://docs.lance.so/llms.txt > Use this file to discover all available pages before exploring further. # Search People by Company > Search for people at a specific company with pagination support Search for people (contacts/employees) at a specific company using the Lance database. Results are automatically mapped and upserted to the database for future reference. ## Authentication This endpoint requires authentication. The user must be logged in. The search prioritizes company matching in this order: LinkedIn URL, domain, then company name. Companies must have at least one of these identifiers to be searchable. ## Request ### Path Parameters The unique identifier (UUID) of the company to search people for. ### Query Parameters Page number for pagination (0-indexed). Values less than 0 are normalized to 0\. Number of results per page. Must be between 1 and 100. Values outside this range are clamped to the nearest valid value. ## Response Array of person objects found at the company. Unique identifier (UUID) for the person. ISO 8601 timestamp when the person record was created. Can be null. ISO 8601 timestamp when the person record was last updated. Can be null. Person's first name. Person's last name. Current job title/position. Can be null. City of residence/work. Can be null. Postal/zip code. Can be null. Country of residence/work. Can be null. LinkedIn profile URL (normalized to [https://www.linkedin.com](https://www.linkedin.com) format). Can be null. Array of phone numbers. Defaults to empty array. Array of email addresses (lowercased). Defaults to empty array. UUID of the associated company (matches the requested company ID). Seniority level (e.g., "Senior", "Manager", "Director"). Can be null. Industry classification. Can be null. ISO 8601 date of birth. Can be null. Array of department names. Defaults to empty array. Array of sub-department names. Defaults to empty array. Array of job functions. Defaults to empty array. Array of professional skills. Defaults to empty array. Array of language proficiencies. Defaults to empty array. Language name (e.g., "English", "German"). Can be null. Proficiency level (e.g., "Native", "Fluent"). Can be null. Array of education records. Defaults to empty array. Educational institution details. Institution ID. Can be null. Institution name. Can be null. Logo URL. Can be null. LinkedIn URL. Can be null. Degree name (e.g., "Bachelor of Science"). Can be null. Field of study (e.g., "Computer Science"). Can be null. Grade or GPA. Can be null. Start and end dates with `start` and `end` as string dates. Can be null. Array of work experience records. Defaults to empty array. Company information. Can be null. Company ID. Can be null. Company name. Can be null. Logo URL. Can be null. LinkedIn URL. Can be null. Employee count range with `start` and `end`. Can be null. Employment dates with `start` and `end` as string dates. Can be null. Array of positions held at the company. Can be null. Company name. Can be null. Position description. Can be null. Job title. Can be null. Employment type (Full-time, Part-time, etc.). Can be null. Work location. Can be null. Position dates. Can be null. Array of professional certificates. Defaults to empty array. Certificate name. Can be null. Issuing authority. Can be null. Certificate URL. Can be null. License number. Can be null. Display source. Can be null. Issue and expiry dates. Can be null. LinkedIn profile information. Can be null. LinkedIn headline. Can be null. LinkedIn summary/about section. Can be null. Profile picture URL. Can be null. Internal provider indentifier. Can be null. Bullhorn CRM identifier. Can be null. Generic CRM identifier. Can be null. ID of the user who owns this lead. Can be null. GDPR consent status. Values: `UNKNOWN`, `OPTOUT`. Defaults to `UNKNOWN`. Source of consent information. Can be null. ISO 8601 timestamp when consent was last updated. Can be null. ISO 8601 timestamp when the person was soft-deleted. Null if active. Total number of people matching the search criteria across all pages. Total number of pages available based on size parameter. Current page number (0-indexed). Number of results per page. ## Examples ```bash Basic Search theme={null} curl -X GET "https://api.lance.app/api/v1/entities/prospects/company/550e8400-e29b-41d4-a716-446655440000/people/search" \ -H "Authorization: Bearer " ``` ```bash With Pagination theme={null} curl -X GET "https://api.lance.app/api/v1/entities/prospects/company/550e8400-e29b-41d4-a716-446655440000/people/search?page=0&size=50" \ -H "Authorization: Bearer " ``` ```bash Page Through Results theme={null} curl -X GET "https://api.lance.app/api/v1/entities/prospects/company/550e8400-e29b-41d4-a716-446655440000/people/search?page=2&size=25" \ -H "Authorization: Bearer " ``` ```json Success Response theme={null} { "content": [ { "id": "7c9e6679-7425-40de-944b-e07fc1f90ae7", "createdAt": "2024-01-15T10:30:00.000Z", "updatedAt": "2024-01-15T10:30:00.000Z", "firstName": "Jane", "lastName": "Smith", "jobTitle": "VP of Engineering", "city": "San Francisco", "postalCode": "94105", "country": "United States", "linkedinUrl": "https://www.linkedin.com/in/janesmith", "phones": ["+1-555-987-6543"], "emails": ["jane.smith@acmetech.com"], "companyId": "550e8400-e29b-41d4-a716-446655440000", "seniority": "VP", "industry": "Software Development", "birthDate": null, "departments": ["Engineering"], "subDepartments": ["Platform"], "functions": ["Engineering Management"], "skills": ["Leadership", "Software Architecture", "Team Building"], "languages": [ { "language": "English", "level": "Native" }, { "language": "Spanish", "level": "Professional" } ], "educations": [ { "institution": { "id": null, "name": "Stanford University", "logoUrl": "https://media.licdn.com/school/stanford.png", "linkedinUrl": "https://www.linkedin.com/school/stanford-university" }, "degreeName": "Master of Science", "fieldOfStudy": "Computer Science", "grade": null, "dates": { "start": "2008", "end": "2010" } } ], "workExperiences": [ { "company": { "id": null, "name": "Acme Technologies", "logoUrl": "https://media.licdn.com/company/acme.png", "linkedinUrl": "https://www.linkedin.com/company/acme-technologies", "employees": { "start": "201", "end": "500" } }, "dates": { "start": "2020-01", "end": null }, "profilePositions": [ { "company": "Acme Technologies", "description": "Leading the engineering organization...", "title": "VP of Engineering", "employmentType": "Full-time", "location": "San Francisco, CA", "dates": { "start": "2020-01", "end": null } } ] } ], "certificates": [], "linkedinProfile": { "headline": "VP of Engineering at Acme Technologies | Building the future of enterprise software", "summary": "Passionate engineering leader with 15+ years of experience...", "pictureUrl": "https://media.licdn.com/profile/janesmith.jpg" }, "baseProviderId": "ark_person_789012", "bullhornId": null, "crmId": null, "leadOwnerId": null, "consentStatus": "UNKNOWN", "consentSource": null, "consentUpdatedAt": null, "deletedAt": null } ], "totalElements": 156, "totalPages": 7, "page": 0, "size": 25 } ``` ```json Empty Response theme={null} { "content": [], "totalElements": 0, "totalPages": 0, "page": 0, "size": 25 } ``` ## Error Responses Returned when the specified company does not exist in the database. ```json theme={null} { "error": { "code": "NOT_FOUND", "message": "Company 550e8400-e29b-41d4-a716-446655440000 not found" } } ``` Returned when the company exists but lacks sufficient data for searching (missing LinkedIn URL, domain, and company name). ```json theme={null} { "error": { "code": "VALIDATION_ERROR", "message": "Company cannot be searched in our database: missing LinkedIn URL, domain, and name" } } ``` ## Search Strategy The endpoint uses a prioritized search strategy to find people at a company: 1. **LinkedIn URL** (most reliable): If the company has a LinkedIn company page URL, it is used as the primary filter. 2. **Domain** (good fallback): If no LinkedIn URL is available, the company's domain is used to match people. 3. **Company Name** (last resort): If neither LinkedIn URL nor domain is available, the company name is used. This may have more false positives as company names are not unique. Results are automatically upserted to the database. Existing person records are updated with new data, and new persons are created with fresh UUIDs. ## Performance Notes This endpoint is optimized for performance: * Batch fetches existing persons in a single database query * Uses synchronous mapping instead of N+1 database lookups * Bulk upserts all persons in one operation For large result sets, use pagination to avoid memory issues and improve response times.