> ## Documentation Index > Fetch the complete documentation index at: https://agnt.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Search people > Search the people graph using structured filters (job title, company, location, seniority, department, …). Returns paginated profile summaries. ## OpenAPI ````yaml /openapi/agnt.openapi.json post /v1/data/agnt/people/search openapi: 3.0.0 info: title: agntdata Lead APIs description: >- Internal lead enrichment API surface that orchestrates multiple upstream data providers behind a single endpoint per use case. Use these endpoints to find and verify professional emails, find mobile phone numbers, enrich and search people and companies, discover companies, list a domain's email addresses, run bulk people/company enrichments, and fetch company intelligence (funding/competitors/technographics). Provider names are never returned — agntdata picks the cheapest providers that can fulfill the requested fields and merges results. version: 1.0.0 contact: name: agntdata url: https://agntdata.dev servers: - url: https://api.agntdata.dev description: agntdata API security: - ApiKeyAuth: [] tags: - name: People — Email description: Find, verify, and enrich professional email addresses. - name: People — Enrich description: Enrich people with structured profile data. - name: People — Mobile description: Find mobile phone numbers from a profile. - name: People — Search description: Search the people graph by structured filters. - name: Companies — Discover description: Discover companies that match a set of criteria. - name: Companies — Email description: List the email addresses found for a company domain. - name: Companies — Enrich description: Enrich companies with firmographic data. - name: Companies — Search description: Search the company graph by structured filters. - name: Companies — Intelligence description: Funding, competitors, and technographics for a company. paths: /v1/data/agnt/people/search: post: tags: - People — Search summary: Search people description: >- Search the people graph using structured filters (job title, company, location, seniority, department, …). Returns paginated profile summaries. operationId: people_search requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/PeopleSearchRequest' example: filters: job_title: founder location: San Francisco page: 1 responses: '200': description: People search results. content: application/json: schema: $ref: '#/components/schemas/Post_agnt_people_search_Response' '400': description: Validation error. '401': description: Unauthorized. security: - ApiKeyAuth: [] components: schemas: PeopleSearchRequest: type: object properties: filters: type: object additionalProperties: {} description: >- Filter object. Each entry is keyed by filter name and takes either `{ include?: string[], exclude?: string[] }` for categorical filters or `{ min?, max? }` for ranges. Searches that contain ONLY `exclude` filters are rejected — always pair with at least one positive filter. Common keys: `person_job_title` ({ include/exclude } — free-text titles, e.g. ["VP of Sales"]); `person_seniority` ({ include/exclude } — allowed values: "Owner", "Founder/Owner", "C-Suite", "Partner", "VP", "Director", "Manager", "Senior", "Entry", "Training"); `person_department` ({ include/exclude } — allowed values: "Accounting", "Administrative", "Arts and Design", "Business Development", "Community and Social Services", "Consulting", "Education", "Engineering", "Entrepreneurship", "Finance", "Healthcare Services", "Human Resources", "Information Technology", "Legal", "Marketing", "Media and Communication", "Military and Protective Services", "Operations", "Product Management", "Program and Project Management", "Purchasing", "Quality Assurance", "Real Estate", "Research", "Sales", "Support"); `person_year_of_experience` ({ min, max } — numeric years range); `company` ({ names: { include?, exclude? }, websites: { include?, exclude? } } — pre-filter to a list of companies, max 500 entries each); `company_industry` ({ include/exclude } — e.g. ["Software Development"]); `company_headcount_custom` ({ min, max } — numeric employee count range); `company_location_search` ({ include/exclude } — country / location strings). Values are case-sensitive — pass them in the exact casing shown above (e.g. "C-Suite" not "c_suite", "Business Development" not "business_development"). For convenience, flat aliases are accepted and translated server-side: `seniority` → `person_seniority.include`, `department` → `person_department.include`, `job_title`/`title` → `person_job_title.include`, `location`/`country` → `person_location_search.include`, `company_name`/`company_names` → `company.names.include`, `company_domain`/`company_website` → `company.websites.include`, `headcount_min`/`headcount_max` → `company_headcount_custom.{min,max}`, `years_of_experience_min`/`years_of_experience_max` → `person_year_of_experience.{min,max}`. Top-level keys other than `filters`/`page` are ignored. Example: `{ "filters": { "company_name": "Zillow", "department": ["Sales", "Marketing"], "seniority": ["C-Suite", "VP", "Director"] }, "page": 1 }`. page: type: integer exclusiveMinimum: true minimum: 0 description: Page number (25 results per page; max page = 1000). additionalProperties: false Post_agnt_people_search_Response: type: object required: - success - data properties: success: type: boolean enum: - true data: $ref: '#/components/schemas/PeopleSearchResponse' meta: $ref: '#/components/schemas/AgntMeta' PeopleSearchResponse: type: object AgntMeta: type: object properties: costCents: type: number purchasedBalanceCents: type: number subscriptionRemainingCents: type: number cached: type: boolean latencyMs: type: number priceRange: type: object properties: minCents: type: number maxCents: type: number required: - minCents - maxCents additionalProperties: false budgetCents: type: number budgetCentsPerRecord: type: number providersAttempted: type: number fieldsReturned: type: array items: type: string fieldsMissing: type: array items: type: string records: type: number required: - costCents - purchasedBalanceCents - subscriptionRemainingCents - cached - latencyMs additionalProperties: true securitySchemes: ApiKeyAuth: type: apiKey in: header name: Authorization description: >- Bearer token. Pass your agntdata API key as: Authorization: Bearer agnt_live_... ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.