--- title: "Find person or company by phone (single)" method: POST path: "/v1/phone-to-person/single" tags: ["Reverse lookup"] --- # Find person or company by phone (single) `POST /v1/phone-to-person/single` Given a phone number, find the associated LinkedIn profile or company. Mobile and home phones typically resolve to people, while front desk or business phones may resolve to companies. Only charges 1 credit when a result is found. No charge for invalid numbers or misses. If you have additional identifiers (name, company, email) beyond just the phone number, use the Kitchen Sink endpoint instead for better match quality. โšก Rate limit: 600 requests per 1 minute ๐Ÿ’ฐ Cost: 3 credits per phone lookup โ“˜ โฑ Recommended timeout: 30 seconds โ“˜ ## Request body - object - `apiKey` string, required โ€” Your Fiber API key - `phoneNumber` string, required โ€” The phone number to look up. Accepts E.164 format (+12125551234) or various national formats. ## Response `200` Default Response - object - `output` object, required - `results` union[], required โ€” LinkedIn profiles or companies matching this phone number. Usually contains one result. - union - object - `type` 'profile', required - `profile` object, required - `articles` object[], nullable - โ€ฆ - `certifications` object[], nullable - โ€ฆ - `connection_count` number, nullable - `courses` object[], nullable - โ€ฆ - `dob` string, nullable - `education` object[], nullable - โ€ฆ - `experiences` object[], nullable - โ€ฆ - `first_name` string, nullable - `follower_count` number, nullable - `headline` string, nullable - `industry_name` string, nullable - `inferred_location` object, nullable - โ€ฆ - `interests` string[], nullable - `last_name` string, nullable - `locality` string, nullable - `name` string, nullable - `patents` object[], nullable - โ€ฆ - `profile_pic` string, nullable - `projects` object[], nullable - โ€ฆ - `publications` object[], nullable - โ€ฆ - `skills` string[], nullable - `primary_slug` string, required - `slugs` string[], nullable - `summary` string, nullable - `url` string, nullable - `user_id` string, nullable - `volunteering` object[], nullable - โ€ฆ - `tenures` object[], nullable - โ€ฆ - `career_began_at` string, nullable - `tags` string[], nullable - `entity_urn` string, nullable - `open_to_work` boolean, nullable - `premium` boolean, nullable - `influencer` boolean, nullable - `organizations` object[], nullable - โ€ฆ - `entity_urns` string[], nullable - `is_hiring` boolean, nullable - `websites` string[], nullable - `is_verified` boolean, nullable - `verifications` object, nullable - โ€ฆ - `is_top_voice` boolean, nullable - `current_job` object, nullable - โ€ฆ - `custom_data` object, nullable - `relevance_score` number, nullable - `last_sort_key` string, nullable - `last_updated_at` string, nullable - `languages` object[], nullable - โ€ฆ - `detailed_education` object[], nullable - โ€ฆ - `detailed_work_experiences` object[], nullable - โ€ฆ - object - `type` 'company', required - `company` object, required - `headline` string, nullable - `description` string, nullable - `employee_count` number, nullable - `follower_count` number, nullable - `founded_year` number, nullable - `industries` object[], nullable - โ€ฆ - `inferred_location` object, nullable - โ€ฆ - `linkedin_url` string, nullable - `locations` object[], nullable - โ€ฆ - `naics_codes` string[], nullable - `name` string, nullable - `org_id` string, nullable - `slug` string, required - `specialties` string[], nullable - `ticker` string, nullable - `type` string, nullable - `domain` string, nullable - `website` string, nullable - `est_employee_count_lower_bound` number, nullable - `est_employee_count_upper_bound` number, nullable - `standardized_industries` string[], nullable - `locations_stats` object, nullable - โ€ฆ - `logo_url` string, nullable - `historical_headcount` object, nullable - โ€ฆ - `revenue_usd_lower_bound` string, nullable - `revenue_usd_upper_bound` string, nullable - `rejectionReason` object, nullable โ€” Present when the phone number is unresolvable (e.g. invalid format, not found). - `reason` string, required โ€” Why the phone number couldn't be resolved - `chargeInfo` union, required - object โ€” Credits were charged immediately for this operation - `method` 'charged-now', required - `creditsCharged` number, required - `lowCreditAlert` object, nullable โ€” Contains a link to get more credits, a warning message, and the remaining credit count. - `getMoreCreditsUrl` string, uri, required โ€” URL to top up credits or restart billing cycle to get fresh credits. - `message` string, required โ€” Human-readable credits warning. - `availableCredits` number, required โ€” Number of credits remaining in the current billing period. - object โ€” Credits will be charged after the operation completes - `method` 'charging-later', required - `message` string, required - `lowCreditAlert` object, nullable โ€” Contains a link to get more credits, a warning message, and the remaining credit count. - `getMoreCreditsUrl` string, uri, required โ€” URL to top up credits or restart billing cycle to get fresh credits. - `message` string, required โ€” Human-readable credits warning. - `availableCredits` number, required โ€” Number of credits remaining in the current billing period. - object โ€” Credits that were charged for an asynchronous operation - `method` 'charged-for-async-process', required - `creditsCharged` number, required - `message` string, required - `lowCreditAlert` object, nullable โ€” Contains a link to get more credits, a warning message, and the remaining credit count. - `getMoreCreditsUrl` string, uri, required โ€” URL to top up credits or restart billing cycle to get fresh credits. - `message` string, required โ€” Human-readable credits warning. - `availableCredits` number, required โ€” Number of credits remaining in the current billing period. - object โ€” No credits were charged for this operation - `method` 'free', required - `message` string, required - `lowCreditAlert` object, nullable โ€” Contains a link to get more credits, a warning message, and the remaining credit count. - `getMoreCreditsUrl` string, uri, required โ€” URL to top up credits or restart billing cycle to get fresh credits. - `message` string, required โ€” Human-readable credits warning. - `availableCredits` number, required โ€” Number of credits remaining in the current billing period. - object โ€” Credits were refunded for this operation - `method` 'credits-refunded', required - `creditsRefunded` number, required - `message` string, required - `lowCreditAlert` object, nullable โ€” Contains a link to get more credits, a warning message, and the remaining credit count. - `getMoreCreditsUrl` string, uri, required โ€” URL to top up credits or restart billing cycle to get fresh credits. - `message` string, required โ€” Human-readable credits warning. - `availableCredits` number, required โ€” Number of credits remaining in the current billing period. - `warnings` object[], nullable โ€” Warnings about extraneous fields in request - `field` string, required โ€” Full path to extraneous field (e.g., 'searchParams.ExtraField') - `message` string, required โ€” Warning message - `advice` string[], nullable โ€” Tips, recommendations, and suggestions for using this API effectively. ## Other responses - `400` โ€” Default Response - `401` โ€” Default Response - `402` โ€” Default Response - `403` โ€” Default Response - `404` โ€” Default Response - `422` โ€” Default Response - `429` โ€” Default Response - `500` โ€” Default Response - `503` โ€” Default Response --- [API](https://skmtc.net/fiber/apis/fiber-ai-api.md) ยท [All operations](https://skmtc.net/fiber/apis/fiber-ai-api/llms.txt) ยท [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/fiber/fiber-ai-api/revisions/720c63a313eb/schema)