> ## Documentation Index > Fetch the complete documentation index at: https://fe-dev.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Search People > Search for people based on various filters. Multiple filters within the same field are combined with AND logic. The People Search endpoint lets you build precise **lists of individuals based** on role, seniority, skills, location, company attributes, and career history. You can combine multiple filters to narrow down exactly the profiles you are looking for, whether you are targeting new hires, decision-makers, or specific personas. **If you already know exactly who you want to retrieve**, you can also search for a specific person using their LinkedIn profile URL, which is the most reliable way to match a single individual. For a full list of supported filters and accepted values (industries, company types, seniority levels, etc.) For a full list of supported filters and accepted values (industries, company types, seniority levels, etc.) ## OpenAPI ````yaml api/v2/reference/openapi.yml post /people/search openapi: 3.1.0 info: title: FullEnrich API Documentation version: 2.0.0 description: > FullEnrich API enables you to enrich B2B contacts with emails and phone numbers using data from 20+ providers. We are GDPR and CCPA compliant. servers: - url: https://app.fullenrich.com/api/v2 security: [] paths: /people/search: post: summary: Search people description: >- Search for people based on various filters. Multiple filters within the same field are combined with AND logic. operationId: postPeopleSearch requestBody: content: application/json: schema: $ref: '#/components/schemas/SearchPeopleRequest' responses: '200': description: OK content: application/json: schema: allOf: - $ref: '#/components/schemas/SearchPeopleResponse' - $ref: '#/components/schemas/Metadata' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Error' examples: AuthorizationHeaderNotSet: value: code: error.authorization.not_set message: Authorization headers not set AuthorizationHeaderNotAnBearer: value: code: error.authorization.not_bearer message: Authorization headers do not have prefix 'bearer' UnknownApiKey: value: code: error.api.key message: Unknown api key '429': description: Too Many Requests content: application/json: schema: $ref: '#/components/schemas/Error' examples: RateLimitExceeded: value: code: error.rate.limit message: Too many requests. Try again in 1m security: - BearerAuth: [] components: schemas: SearchPeopleRequest: type: object properties: offset: type: integer description: Number of people to skip (use this for pagination) example: 0 limit: type: integer description: 'Number of people to return (default: 10, max: 100)' example: 20 current_company_names: type: array description: >- Filter by current company names. Use exact_match for precise company name matching. items: type: object properties: value: type: string description: The string value to filter by example: Anthropic exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: true example: - value: Anthropic exact_match: true exclude: false - value: OpenAI exact_match: true exclude: false current_company_domains: type: array description: >- Filter by current company domains (e.g., 'google.com', 'microsoft.com'). Exact match recommended for domains. items: type: object properties: value: type: string description: The string value to filter by example: google.com exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: true example: - value: google.com exact_match: true exclude: false current_company_linkedin_urls: type: array description: Filter by current company LinkedIn URLs. items: type: object properties: value: type: string description: The string value to filter by example: https://www.linkedin.com/company/fullenrich exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: true example: - value: https://www.linkedin.com/company/fullenrich exact_match: true exclude: false current_company_specialties: type: array description: Filter by current company specialties. items: type: object properties: value: type: string description: The string value to filter by example: artificial intelligence exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: true example: - value: artificial intelligence exact_match: true exclude: false current_company_industries: type: array description: >- Filter by company industries (e.g., 'Software Development', 'Computer Hardware Manufacturing', 'Housing and Community Development', 'Warehousing') items: type: object properties: value: type: string description: The string value to filter by example: Software Development exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: false example: - value: Software Development exact_match: false exclude: false - value: Computer Hardware Manufacturing exact_match: false exclude: false past_company_names: type: array description: >- Filter by past company names. Useful for finding people with specific work history. items: type: object properties: value: type: string description: The string value to filter by example: Meta exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: true example: - value: Meta exact_match: true exclude: false past_company_domains: type: array description: Filter by past company domains items: type: object properties: value: type: string description: The string value to filter by example: facebook.com exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: true example: - value: facebook.com exact_match: true exclude: false current_company_types: type: array description: >- Filter by company types (e.g., 'Public Company', 'Privately Held', 'Non-profit', 'Self-employed') items: type: object properties: value: type: string description: The string value to filter by example: Public Company exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: true example: - value: Public Company exact_match: true exclude: false current_company_headquarters: type: array description: >- Filter by company headquarters locations (city names, regions, or countries) items: type: object properties: value: type: string description: The string value to filter by example: San Francisco exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: false example: - value: San Francisco exact_match: false exclude: false - value: New York exact_match: false exclude: false current_company_headcounts: type: array description: >- Filter by company size (number of employees). Use ranges to target specific company sizes. items: type: object properties: min: type: integer description: Minimum number of employees (inclusive) example: 50 max: type: integer description: Maximum number of employees (inclusive) example: 500 exclude: type: boolean description: If true, excludes companies in this range example: false example: - min: 50 max: 200 exclude: false - min: 1000 max: 5000 exclude: false current_company_founded_years: type: array description: >- Filter by company founding year. Useful for targeting startups or established companies. items: type: object properties: min: type: integer description: Minimum founding year (inclusive) example: 2015 max: type: integer description: Maximum founding year (inclusive) example: 2024 exclude: type: boolean description: If true, excludes companies founded in this range example: false example: - min: 2020 max: 2024 exclude: false current_company_ids: type: array description: Filter by specific company IDs items: type: object properties: value: type: string description: The string value to filter by example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: true person_ids: type: array description: Filter by specific person IDs items: type: object properties: value: type: string description: The string value to filter by example: 746e4816-19c8-54d8-b558-65a5a52cc85c exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: true person_names: type: array description: Filter by person names (first name, last name, or full name) items: type: object properties: value: type: string description: The string value to filter by example: John Smith exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: false example: - value: John Smith exact_match: false exclude: false person_linkedin_urls: type: array description: Filter by person LinkedIn URLs. items: type: object properties: value: type: string description: The string value to filter by example: https://www.linkedin.com/in/john-doe exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: true example: - value: https://www.linkedin.com/in/john-doe exact_match: true exclude: false person_locations: type: array description: Filter by person locations (city, region, or country) items: type: object properties: value: type: string description: The string value to filter by example: San Francisco exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: false example: - value: San Francisco exact_match: false exclude: false - value: California exact_match: false exclude: false person_skills: type: array description: >- Filter by skills (e.g., 'JavaScript', 'Python', 'Project Management') items: type: object properties: value: type: string description: The string value to filter by example: JavaScript exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: false example: - value: JavaScript exact_match: false exclude: false - value: Python exact_match: false exclude: false - value: Project Management exact_match: false exclude: false current_position_seniority_level: type: array description: >- Filter by person seniority levels (e.g., 'Entry level', 'Mid-Senior level', 'Director', 'Executive', 'VP', 'C-level') items: type: object properties: value: type: string description: The string value to filter by example: Director exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: false example: - value: Director exact_match: false exclude: false - value: VP exact_match: false exclude: false current_position_titles: type: array description: >- Filter by current job titles (e.g., 'Software Engineer', 'Product Manager', 'CEO') items: type: object properties: value: type: string description: The string value to filter by example: Chief Technology Officer exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: false example: - value: Chief Technology Officer exact_match: false exclude: false - value: VP of Engineering exact_match: false exclude: false past_position_titles: type: array description: >- Filter by past job titles. Useful for finding people who held specific roles. items: type: object properties: value: type: string description: The string value to filter by example: Software Engineer exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: false example: - value: Software Engineer exact_match: false exclude: false current_position_years_in: type: array description: >- Filter by years spent in current position. Useful for targeting people new in role or experienced. items: type: object properties: min: type: integer description: Minimum years in current position (inclusive) example: 0 max: type: integer description: Maximum years in current position (inclusive) example: 2 exclude: type: boolean description: If true, excludes people in this range example: false example: - min: 0 max: 1 exclude: false current_company_years_at: type: array description: >- Filter by years at current company (tenure). Useful for targeting new hires or long-term employees. items: type: object properties: min: type: integer description: Minimum years at current company (inclusive) example: 1 max: type: integer description: Maximum years at current company (inclusive) example: 5 exclude: type: boolean description: If true, excludes people in this range example: false example: - min: 2 max: 5 exclude: false person_universities: type: array description: >- Filter by universities attended (e.g., 'Stanford University', 'MIT', 'Harvard') items: type: object properties: value: type: string description: The string value to filter by example: Stanford University exclude: type: boolean description: >- If true, excludes results matching this value. If false or omitted (default), includes only matching results. example: false exact_match: type: boolean description: >- When true, the exact term must appear within the value, but can still be part of a longer string. When false (default), matching is flexible and tolerates slight variations such as missing or extra words. Matching is never case-sensitive. example: false example: - value: Stanford University exact_match: false exclude: false - value: MIT exact_match: false exclude: false current_company_days_since_last_job_change: type: array description: >- Filter by days since last job change. Useful for finding people who recently changed jobs. items: type: object properties: min: type: integer description: Minimum days since last job change (inclusive) example: 0 max: type: integer description: Maximum days since last job change (inclusive) example: 90 exclude: type: boolean description: If true, excludes people in this range example: false example: - min: 0 max: 90 exclude: false SearchPeopleResponse: type: object properties: people: type: array description: >- Array of people matching the search criteria. Returns empty array if no results found. items: $ref: '#/components/schemas/Person' Metadata: type: object properties: metadata: type: object properties: total: type: integer description: Total number of results matching the search criteria example: 20523 offset: type: integer description: Number of results skipped (for pagination) example: 0 Error: type: object properties: code: type: string message: type: string required: - code - message Person: type: object properties: id: type: string description: Unique person identifier example: 746e4816-19c8-54d8-b558-65a5a52cc85c full_name: type: string description: Person's full name example: Enzo Romera first_name: type: string description: Person's first name example: Enzo last_name: type: string description: Person's last name example: Romera location: type: object description: Person's location information properties: country: type: string description: Country name example: France country_code: type: string description: ISO country code example: FR city: type: string description: City name example: Paris region: type: string description: Region or state example: IDF social_profiles: type: object description: Person's social media profiles allOf: - $ref: '#/components/schemas/PersonSocialProfile' educations: type: array description: Person's education history items: $ref: '#/components/schemas/PersonEducation' languages: type: array description: Languages spoken by the person items: $ref: '#/components/schemas/PersonLanguage' skills: type: array description: Person's professional skills items: type: string example: - JavaScript - Project Management - Python employment: type: object description: Person's employment history properties: current: type: object description: >- Current employment information. If the person is in their current position, the end_at field will not be returned. allOf: - $ref: '#/components/schemas/Employment' all: type: array description: All employment history (current and past) items: $ref: '#/components/schemas/Employment' PersonSocialProfile: type: object properties: linkedin: type: object description: LinkedIn profile information properties: url: type: string description: Full LinkedIn profile URL example: https://www.linkedin.com/in/john-doe handle: type: string description: LinkedIn profile handle/username example: john-doe connection_count: type: integer description: Number of LinkedIn connections example: 500 PersonEducation: type: object properties: school_name: type: string description: Name of the educational institution example: Stanford University degree: type: string description: Degree or qualification obtained example: Bachelor of Science in Computer Science start_at: type: string format: date-time description: >- Start date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ) example: '2015-09-01T00:00:00Z' end_at: type: string format: date-time description: End date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ) example: '2019-06-01T00:00:00Z' PersonLanguage: type: object properties: language: type: string description: Language name example: French code: type: string description: ISO language code example: FR proficiency: type: string description: >- Proficiency level (e.g., 'Native or Bilingual', 'Professional Working', 'Limited Working', 'Elementary') example: Native or Bilingual Employment: type: object properties: title: type: string description: Job title or position example: Senior Software Engineer company: type: object description: Company information allOf: - $ref: '#/components/schemas/EmploymentCompany' is_current: type: boolean description: Whether this is the current employment example: true start_at: type: string format: date-time description: >- Employment start date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ) example: '2022-03-15T00:00:00Z' end_at: type: string format: date-time description: >- Employment end date in ISO 8601 format with T separator (YYYY-MM-DDTHH:MM:SSZ). This field is not returned for current employment (when is_current is true). example: '2024-06-30T00:00:00Z' EmploymentCompany: type: object properties: id: type: string description: Unique company identifier example: a1b2c3d4-e5f6-7890-abcd-ef1234567890 name: type: string description: Company name example: Anthropic domain: type: string description: Company domain example: anthropic.com description: type: string description: Company description example: AI safety and research company year_founded: type: integer description: Year the company was founded example: 2021 headcount: type: integer description: Number of employees example: 2610 company_type: type: string description: >- Type of company (e.g., 'Public Company', 'Privately Held', 'Non-profit', 'Self-employed') example: Privately Held locations: type: object description: Company location information properties: headquarters: type: object description: Main headquarters address allOf: - $ref: '#/components/schemas/CompanyAddress' offices: type: array description: Additional office locations items: $ref: '#/components/schemas/CompanyAddress' industry: type: object description: Company industry information properties: main_industry: type: string description: >- Primary industry category (e.g., 'Software Development', 'Computer Hardware Manufacturing', 'Financial Services', 'Healthcare') example: Software Development social_profiles: type: object description: Company's social media profiles allOf: - $ref: '#/components/schemas/CompanySocialProfile' CompanyAddress: type: object properties: line1: type: string description: Address line 1 (street address) example: 548 Market St line2: type: string description: Address line 2 (suite, building, etc.) example: PMB 42570 city: type: string description: City name example: San Francisco region: type: string description: State or region example: California country: type: string description: Country name example: United States country_code: type: string description: ISO country code example: US CompanySocialProfile: type: object properties: linkedin: type: object description: LinkedIn profile information properties: url: type: string description: Full LinkedIn profile URL example: https://www.linkedin.com/company/anthropic handle: type: string description: LinkedIn profile handle/username example: anthropic follower_count: type: integer description: Number of LinkedIn followers example: 125000 securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: string ````