> ## Documentation Index > Fetch the complete documentation index at: https://docs.tryhuntr.com/llms.txt > Use this file to discover all available pages before exploring further. # Phone Finder > Find a phone number for a known person from LinkedIn URL or name plus company domain. ## OpenAPI ````yaml /openapi.json post /person-phone openapi: 3.0.3 info: title: Huntr — The GTM Intelligence API description: >- Give AI agents company, people, contact, and web intelligence through one API. Search accounts, build targeted lists, enrich leads, find contacts, and uncover buying signals. **Authentication:** Authenticated endpoints require an `x-api-key` header with your Huntr API key. Get a key by signing up via `POST /keys/create`. Public endpoints (pricing, sign-up, health) work without a key. **Rate limit:** 5 requests/second per API key on authenticated endpoints. version: 2.0.0 servers: - url: https://api.tryhuntr.com security: [] tags: - name: Contact APIs description: >- Search people and enrich work email, phone, and reverse-email contact fields. - name: Company APIs description: >- Search companies and retrieve company-level attributes such as detected technology stack and active job postings. - name: Research APIs description: >- Research one company, person, team, or focused business question and return a sales-ready answer. Lite, standard, and deep tiers. - name: LinkedIn APIs description: >- LinkedIn URL discovery, company and profile pages, posts, reactions, and comments. - name: X APIs description: X profiles, posts, search results, and thread context. - name: Web APIs description: >- Find, scrape, and analyze pages on a domain, plus tech stack, domain contacts, and job postings. - name: Account description: >- Sign up, verify email, recover keys, check balance, view usage, add credits, and read the public pricing matrix. - name: System description: Health check. paths: /person-phone: post: tags: - Contact APIs summary: Phone Finder description: >- Find a phone number for a known person from LinkedIn URL or name plus company domain. requestBody: required: true content: application/json: schema: type: object properties: linkedin_url: type: string description: >- LinkedIn profile URL. Optional when company_url, first_name, and last_name are provided. company_url: type: string description: >- Company website URL or domain. Required with first_name and last_name when linkedin_url is not provided. first_name: type: string description: >- Employee first name. Required with company_url and last_name when linkedin_url is not provided. last_name: type: string description: >- Employee last name. Required with company_url and first_name when linkedin_url is not provided. additionalProperties: false description: >- Choose one lookup input: - LinkedIn URL lookup: send linkedin_url. - Name and company lookup: send company_url, first_name, and last_name. examples: company_and_name: summary: Company URL with first and last name description: >- Name and company lookup: use company_url, first_name, and last_name when the LinkedIn profile URL is unknown. value: company_url: example.com first_name: Jane last_name: Doe linkedin_url: summary: LinkedIn profile URL description: >- LinkedIn URL lookup: use linkedin_url when you already know the person's profile URL. value: linkedin_url: https://linkedin.com/in/janedoe responses: '200': description: Phone lookup complete. content: application/json: schema: type: object properties: success: type: boolean request_id: type: string result: type: object properties: first_name: type: string nullable: true last_name: type: string nullable: true company_name: type: string nullable: true company_url: type: string nullable: true phone: type: string nullable: true description: Employee phone number when found. phone_type: type: string nullable: true description: Phone type, e.g. direct. employee_count: type: string nullable: true description: Company size range label, e.g. 51-200. address: type: string nullable: true city: type: string nullable: true region_code: type: string nullable: true description: State/province code, e.g. CA. zip: type: string nullable: true country_code: type: string nullable: true description: ISO 2-letter country code, e.g. US. status: type: string description: FOUND or NOT_FOUND. price: type: number description: Plan-specific amount when a phone number is found. credits_remaining: type: number required: - success - request_id - result - price - credits_remaining examples: found: summary: Phone found value: success: true request_id: req_1746123456_ph1x2y result: first_name: Jane last_name: Doe company_name: Example Corp company_url: https://example.com phone: +1-555-0123 phone_type: direct employee_count: 51-200 address: 123 Main St city: San Francisco region_code: CA zip: '94105' country_code: US status: FOUND price: 0.12 credits_remaining: 4.88 not_found: summary: Phone not found (not charged) value: success: true request_id: req_1746123456_ph1x3y result: phone: null phone_type: null status: NOT_FOUND price: 0 credits_remaining: 5 '400': description: Invalid input. content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: Insufficient credits. content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Lookup failed. content: application/json: schema: $ref: '#/components/schemas/Error' security: - ApiKeyAuth: [] x-codeSamples: - lang: Shell label: Name and company lookup source: |- curl --request POST \ --url https://api.tryhuntr.com/person-phone \ --header 'x-api-key: ' \ --header 'Content-Type: application/json' \ --data '{ "company_url": "example.com", "first_name": "Jane", "last_name": "Doe" }' - lang: Shell label: LinkedIn URL lookup source: |- curl --request POST \ --url https://api.tryhuntr.com/person-phone \ --header 'x-api-key: ' \ --header 'Content-Type: application/json' \ --data '{ "linkedin_url": "https://linkedin.com/in/janedoe" }' x-code-samples: - lang: Shell label: Name and company lookup source: |- curl --request POST \ --url https://api.tryhuntr.com/person-phone \ --header 'x-api-key: ' \ --header 'Content-Type: application/json' \ --data '{ "company_url": "example.com", "first_name": "Jane", "last_name": "Doe" }' - lang: Shell label: LinkedIn URL lookup source: |- curl --request POST \ --url https://api.tryhuntr.com/person-phone \ --header 'x-api-key: ' \ --header 'Content-Type: application/json' \ --data '{ "linkedin_url": "https://linkedin.com/in/janedoe" }' components: schemas: Error: type: object properties: error: type: string description: Human-readable error message. required: - error securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: >- Your Huntr API key. Get one at tryhuntr.com. Pass as x-api-key header on all authenticated requests. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.