> ## Documentation Index > Fetch the complete documentation index at: https://docs.fuseai.com/llms.txt > Use this file to discover all available pages before exploring further. # Find a person's phone > Find a person's mobile or direct phone from their LinkedIn URL, or their name and company. Charged only when one is found, at the key's usage plan price; nothing is saved to your Fuse workspace. Send a `linkedinUrl` (the most precise), or a `name` with a `companyName` or `companyDomain`. The answer carries `status` (`found` or `not_found`), `phone` (null when nothing was found), `linkedinUrl` (the profile matched, null when none) and `creditsCharged`. A value Fuse already knows answers at once; otherwise Fuse's provider waterfall runs within the request, about 10 to 25 s. Nothing found in time answers 504 and charges nothing: retry. Send an `X-Idempotency-Key` header: the same key with the same body is charged once however often it is sent, while a key reused for another person or address is new work. For many people at once, use POST /data/people/enrich-jobs. Only keys whose usage plan includes `people_phone` may call it. Rate limit: the plan's `people_phone` entry. Errors: - `402` `INSUFFICIENT_CREDITS` — The balance cannot pay for a value found; nothing was looked up. - `403` `API_NOT_ON_PLAN` — The key's usage plan does not include `people_phone`. - `422` `PERSON_NOT_IDENTIFIABLE` — Neither a `linkedinUrl` nor a `name` with a company that resolves; nothing was charged. - `429` `RATE_LIMITED` — The plan's per-minute or per-day limit for `people_phone` is spent. Requires one of the following token scopes: data. ## OpenAPI ````yaml /openapi.json post /business/data/people/phone openapi: 3.1.0 info: title: Fuse Business API version: 1.0.0 description: >- External API for lists, campaigns, prospect search and contacts. Authenticate with your API token as HTTP Basic. All paths are under /api/v1. servers: - url: https://api.tryfuse.ai/api/v1 description: Production security: - basicAuth: [] tags: - name: Lists - name: Custom columns - name: Smart columns - name: Exports - name: Campaigns - name: Knowledge hubs - name: Analytics - name: Website intent - name: Account - name: Data - name: Prospect search - name: Campaign steps - name: Scheduled sends - name: Campaign templates - name: Agents - name: Research - name: Company search - name: Saved searches - name: Folders - name: Contacts paths: /business/data/people/phone: post: tags: - Data summary: Find a person's phone description: >- Find a person's mobile or direct phone from their LinkedIn URL, or their name and company. Charged only when one is found, at the key's usage plan price; nothing is saved to your Fuse workspace. Send a `linkedinUrl` (the most precise), or a `name` with a `companyName` or `companyDomain`. The answer carries `status` (`found` or `not_found`), `phone` (null when nothing was found), `linkedinUrl` (the profile matched, null when none) and `creditsCharged`. A value Fuse already knows answers at once; otherwise Fuse's provider waterfall runs within the request, about 10 to 25 s. Nothing found in time answers 504 and charges nothing: retry. Send an `X-Idempotency-Key` header: the same key with the same body is charged once however often it is sent, while a key reused for another person or address is new work. For many people at once, use POST /data/people/enrich-jobs. Only keys whose usage plan includes `people_phone` may call it. Rate limit: the plan's `people_phone` entry. Errors: - `402` `INSUFFICIENT_CREDITS` — The balance cannot pay for a value found; nothing was looked up. - `403` `API_NOT_ON_PLAN` — The key's usage plan does not include `people_phone`. - `422` `PERSON_NOT_IDENTIFIABLE` — Neither a `linkedinUrl` nor a `name` with a company that resolves; nothing was charged. - `429` `RATE_LIMITED` — The plan's per-minute or per-day limit for `people_phone` is spent. Requires one of the following token scopes: data. operationId: findPersonPhone requestBody: required: true content: application/json: schema: type: object properties: linkedinUrl: type: string minLength: 1 maxLength: 2048 description: >- The person's LinkedIn profile, e.g. `https://www.linkedin.com/in/jane-doe`: the most precise way to name them. name: type: string minLength: 1 maxLength: 255 description: >- The person's full name, e.g. `Jane Doe`, with `companyName` or `companyDomain` when no `linkedinUrl` is sent. companyName: type: string minLength: 1 maxLength: 255 description: The person's current employer, e.g. `Stripe`. companyDomain: type: string minLength: 1 maxLength: 253 description: >- The employer's website domain, e.g. `stripe.com`: more precise than `companyName`. description: >- A `linkedinUrl`, or a `name` with a `companyName` or `companyDomain`. responses: '200': description: Success headers: RateLimit-Limit: schema: type: integer description: Requests permitted in the current window. RateLimit-Remaining: schema: type: integer description: Requests remaining in the current window. RateLimit-Reset: schema: type: integer description: Seconds until the current window resets. content: application/json: schema: type: object required: - status - phone - linkedinUrl - creditsCharged properties: status: type: string enum: - found - not_found phone: type: - object - 'null' required: - value properties: value: type: string description: In international format, e.g. `+14155550123`. description: Null when no phone was found. linkedinUrl: type: - string - 'null' creditsCharged: type: integer description: The plan's price when a value was found, else 0. example: status: found phone: value: '+14155550123' linkedinUrl: linkedin.com/in/jane-doe creditsCharged: 200 '400': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '402': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '404': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '409': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '422': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: Error content: application/json: schema: $ref: '#/components/schemas/Error' security: - basicAuth: [] components: schemas: Error: type: object properties: error: type: object properties: code: type: string message: type: string param: type: - string - 'null' doc_url: type: - string - 'null' request_id: type: - string - 'null' required: - code - message required: - error securitySchemes: basicAuth: type: http scheme: basic description: >- Your API token (`af_…`) as the Basic-auth username, with an empty password. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.