> ## Documentation Index > Fetch the complete documentation index at: https://docs.airscale.io/llms.txt > Use this file to discover all available pages before exploring further. # Reverse phone > Find a person profile from a phone number. Rate limit: 2,000 requests per minute per workspace. Submit a phone number and receive the matching person profile when one can be resolved. > [!NOTE] > > The limit is 2,000 requests per minute per workspace. A returned profile costs 10 credits; `not_found` and errors are not charged. A `not_found` result can represent a true miss or lookup paths that were exhausted or failed. When a match is expected, make one bounded-backoff retry. If it persists, verify that you sent the intended normalized number before retrying again. For temporary `502` or `503` responses, use a limited number of retries with increasing delays. If errors persist, stop retrying and contact support. A client timeout does not confirm whether the request completed or was charged. ## Read the profile A match returns the same nested person record as [Reverse email](https://docs.airscale.io/api-reference/reverse-email.md), with **camelCase** keys such as `profile.firstName`, `link.linkedin`, and `positionGroups`. The response also has a `body` field holding a copy of the same record; read either one. When the match comes from a fallback lookup, the record uses the flat fields of [People profile](https://docs.airscale.io/api-reference/extract-people-profile.md) instead. ## Next step Use [People profile](https://docs.airscale.io/api-reference/extract-people-profile.md) when you already have a professional profile URL and want the structured profile directly. ## OpenAPI ````yaml openapi.json POST /v1/reverse-phone openapi: 3.1.0 info: title: Airscale Public API version: '2026-09-11' description: >- Search, enrich, resolve public business data, and monitor job changes with Airscale. x-airscale-source-repository: ViceScale/airscale-code x-airscale-source-sha: 1de19e1b70a052a4b8d9c2075021a7e5e7a94d51 servers: - url: https://api.airscale.io description: Production security: - bearerAuth: [] tags: - name: Search and discovery description: Search people, companies, and the web. - name: Contact data description: Find professional and personal contact data. - name: Profiles and reverse lookup description: Extract profiles or resolve a person from known contact data. - name: Post engagement description: Retrieve and enrich people who liked or commented on LinkedIn posts. - name: LinkedIn content description: >- Search LinkedIn posts, read profile and company feeds, and retrieve profile comments and comment reactions. - name: Job change monitoring description: Track LinkedIn profiles and receive job-change events. - name: New hire monitoring description: Watch companies or the market for people who start a matching role. - name: Post engagement monitoring description: >- Follow LinkedIn company pages and profiles and receive the people who engage with their posts. - name: Account description: Inspect workspace account state. - name: Miscellaneous description: >- Find website technologies and check WhatsApp availability, Meta ads, and email deliverability. paths: /v1/reverse-phone: post: tags: - Profiles and reverse lookup summary: Find a profile from a phone number description: >- Resolves a public person profile from a phone-number string, or returns a not_found status when no profile is available. A match returns the same nested person record as reverse email, plus a body field holding a copy of it. operationId: reversePhoneLookup requestBody: required: true description: >- The mobile_phone value is trimmed before lookup and must contain at least one non-whitespace character. The exact trimmed lowercase strings "null" and "undefined" are treated as missing input. content: application/json: schema: type: object required: - mobile_phone additionalProperties: false properties: mobile_phone: type: string minLength: 1 pattern: ^(?!\s*(?:null|undefined)\s*$)(?=.*\S)[\s\S]+$ examples: phone: summary: Synthetic phone number value: mobile_phone: '+12025550147' responses: '200': description: >- A public person profile in a body envelope, or an exact not_found status. content: application/json: schema: oneOf: - allOf: - anyOf: - $ref: '#/components/schemas/ReverseLookupPerson' - $ref: '#/components/schemas/VariablePersonProfile' - type: object required: - body properties: body: anyOf: - $ref: '#/components/schemas/ReverseLookupPerson' - $ref: '#/components/schemas/VariablePersonProfile' description: >- A copy of the same profile object. It is kept at the top level too for existing integrations. - $ref: '#/components/schemas/NotFoundStatus' examples: success: summary: Profile found value: id: 00000000-0000-0000-0000-000000000000 identifier: example-person-000000 profile: firstName: Example middleName: null lastName: Person fullName: Example Person headline: Founder at Example Company title: Founder summary: Synthetic profile summary for API documentation. birthDate: null background: source: https://www.example.org/images/example-background.png picture: source: https://www.example.org/images/example-person.png link: linkedin: https://www.linkedin.com/in/example-person-000000 twitter: null github: null facebook: null location: default: Example City, Example State, United States short: Example City, United States country: United States state: Example State city: Example City position: null languages: primaryLocale: country: US language: en supportedLocales: - country: US language: en profileLanguages: - name: English proficiency: NATIVE_OR_BILINGUAL industry: Software Development educations: - school: id: '100001' name: Example University url: https://www.linkedin.com/school/example-university/ logo: https://www.example.org/images/example-logo.png degreeName: Master of Science fieldOfStudy: Computer Science grade: null date: start: '2014' end: '2016' certifications: - name: Example Certification authority: Example Institute url: https://www.example.org/certificates/example licenseNumber: EX-000001 displaySource: example.org company: id: '100003' name: Example Institute url: https://www.linkedin.com/company/example-institute/ logo: https://www.example.org/images/example-logo.png date: start: 2022-01 end: null positionGroups: - company: id: '100002' name: Example Company url: >- https://www.linkedin.com/company/example-company-000000 employees: start: 11 end: 50 logo: https://www.example.org/images/example-logo.png date: start: 2021-03 end: null profilePositions: - company: Example Company description: null title: Founder employmentType: Full-time location: Example City, United States date: start: 2021-03 end: null skills: - Sales prospecting - Data enrichment memberBadges: premium: true creator: false openToWork: false hiring: false verified: true influencer: false company: id: '100002' summary: name: Example Company legalName: Example Company Inc. description: Synthetic company description for API documentation. foundedYear: 2021 type: PRIVATELY_HELD industry: Software Development staff: total: 24 range: start: 11 end: 50 logo: source: https://www.example.org/images/example-company.png link: website: https://www.example.org domain: example.org linkedin: >- https://www.linkedin.com/company/example-company-000000 crunchbase: null financial: revenue: annual: start: 1000000 end: 5000000 location: headquarter: continent: North America country: United States state: Example State city: Example City postalCode: '00000' rawAddress: 1 Example Street, Example City, Example State 00000 position: lng: -74 lat: 40 locations: - continent: North America country: United States state: Example State city: Example City postalCode: '00000' rawAddress: >- 1 Example Street, Example City, Example State 00000 position: lng: -74 lat: 40 technologies: - name: Example CRM category: CRM industries: - Software Development languages: - English department: departments: - founder subDepartments: - founder functions: - executive seniority: founder url: https://www.linkedin.com/in/example-person-000000 body: id: 00000000-0000-0000-0000-000000000000 identifier: example-person-000000 profile: firstName: Example middleName: null lastName: Person fullName: Example Person headline: Founder at Example Company title: Founder summary: Synthetic profile summary for API documentation. birthDate: null background: source: >- https://www.example.org/images/example-background.png picture: source: https://www.example.org/images/example-person.png link: linkedin: https://www.linkedin.com/in/example-person-000000 twitter: null github: null facebook: null location: default: Example City, Example State, United States short: Example City, United States country: United States state: Example State city: Example City position: null languages: primaryLocale: country: US language: en supportedLocales: - country: US language: en profileLanguages: - name: English proficiency: NATIVE_OR_BILINGUAL industry: Software Development educations: - school: id: '100001' name: Example University url: >- https://www.linkedin.com/school/example-university/ logo: https://www.example.org/images/example-logo.png degreeName: Master of Science fieldOfStudy: Computer Science grade: null date: start: '2014' end: '2016' certifications: - name: Example Certification authority: Example Institute url: https://www.example.org/certificates/example licenseNumber: EX-000001 displaySource: example.org company: id: '100003' name: Example Institute url: >- https://www.linkedin.com/company/example-institute/ logo: https://www.example.org/images/example-logo.png date: start: 2022-01 end: null positionGroups: - company: id: '100002' name: Example Company url: >- https://www.linkedin.com/company/example-company-000000 employees: start: 11 end: 50 logo: https://www.example.org/images/example-logo.png date: start: 2021-03 end: null profilePositions: - company: Example Company description: null title: Founder employmentType: Full-time location: Example City, United States date: start: 2021-03 end: null skills: - Sales prospecting - Data enrichment memberBadges: premium: true creator: false openToWork: false hiring: false verified: true influencer: false company: id: '100002' summary: name: Example Company legalName: Example Company Inc. description: Synthetic company description for API documentation. foundedYear: 2021 type: PRIVATELY_HELD industry: Software Development staff: total: 24 range: start: 11 end: 50 logo: source: https://www.example.org/images/example-company.png link: website: https://www.example.org domain: example.org linkedin: >- https://www.linkedin.com/company/example-company-000000 crunchbase: null financial: revenue: annual: start: 1000000 end: 5000000 location: headquarter: continent: North America country: United States state: Example State city: Example City postalCode: '00000' rawAddress: >- 1 Example Street, Example City, Example State 00000 position: lng: -74 lat: 40 locations: - continent: North America country: United States state: Example State city: Example City postalCode: '00000' rawAddress: >- 1 Example Street, Example City, Example State 00000 position: lng: -74 lat: 40 technologies: - name: Example CRM category: CRM industries: - Software Development languages: - English department: departments: - founder subDepartments: - founder functions: - executive seniority: founder url: https://www.linkedin.com/in/example-person-000000 notFound: summary: No profile found value: status: not_found '400': description: The JSON body is invalid or a required input is missing or invalid. content: application/json: schema: $ref: '#/components/schemas/Error' '401': $ref: '#/components/responses/Unauthorized' '403': description: >- The workspace cannot complete this request because access or available credits are insufficient. content: application/json: schema: $ref: '#/components/schemas/Error' '413': description: The JSON request body exceeds the 256 KiB limit. content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: >- The workspace rate limit has been exceeded. Try again after the current window resets. content: application/json: schema: $ref: '#/components/schemas/Error' '500': description: >- The request could not be completed because of an unexpected server error. content: application/json: schema: $ref: '#/components/schemas/Error' '502': description: >- The request could not be completed because a required service returned an unsuccessful response. content: application/json: schema: $ref: '#/components/schemas/Error' '503': description: The request is temporarily unavailable. Try again later. content: application/json: schema: $ref: '#/components/schemas/Error' components: schemas: ReverseLookupPerson: type: object additionalProperties: true properties: id: type: - string - 'null' description: Record identifier, when available. identifier: type: - string - 'null' description: Public profile identifier, when available. url: type: - string - 'null' description: Public profile URL, when available. profile: type: - object - 'null' additionalProperties: true description: Name, headline, and profile media. properties: firstName: type: - string - 'null' middleName: type: - string - 'null' lastName: type: - string - 'null' fullName: type: - string - 'null' headline: type: - string - 'null' title: type: - string - 'null' summary: type: - string - 'null' birthDate: {} picture: type: - object - 'null' additionalProperties: true properties: source: type: - string - 'null' background: type: - object - 'null' additionalProperties: true properties: source: type: - string - 'null' profilePictureUrl: type: - string - 'null' description: Profile picture URL, when available. link: type: - object - 'null' additionalProperties: true description: Public profile links. properties: linkedin: type: - string - 'null' twitter: type: - string - 'null' github: type: - string - 'null' facebook: type: - string - 'null' location: type: - object - 'null' additionalProperties: true description: Person location. properties: default: type: - string - 'null' short: type: - string - 'null' country: type: - string - 'null' state: type: - string - 'null' city: type: - string - 'null' position: {} languages: type: - object - 'null' additionalProperties: true properties: primaryLocale: type: - object - 'null' additionalProperties: true properties: country: type: - string - 'null' language: type: - string - 'null' supportedLocales: type: - array - 'null' items: type: - object - 'null' additionalProperties: true properties: country: type: - string - 'null' language: type: - string - 'null' profileLanguages: type: - array - 'null' items: type: - object - 'null' additionalProperties: true properties: name: type: - string - 'null' proficiency: type: - string - 'null' industry: type: - string - 'null' educations: type: - array - 'null' items: type: - object - 'null' additionalProperties: true properties: school: type: - object - 'null' additionalProperties: true properties: id: type: - string - 'null' name: type: - string - 'null' logo: type: - string - 'null' url: type: - string - 'null' degreeName: type: - string - 'null' fieldOfStudy: type: - string - 'null' grade: {} date: type: - object - 'null' additionalProperties: true properties: start: type: - string - 'null' end: type: - string - 'null' description: Null while the role or credential is current. certifications: type: - array - 'null' items: type: - object - 'null' additionalProperties: true properties: name: type: - string - 'null' authority: type: - string - 'null' url: type: - string - 'null' licenseNumber: type: - string - 'null' displaySource: type: - string - 'null' company: type: - object - 'null' additionalProperties: true properties: id: type: - string - 'null' name: type: - string - 'null' logo: type: - string - 'null' url: type: - string - 'null' date: type: - object - 'null' additionalProperties: true properties: start: type: - string - 'null' end: type: - string - 'null' description: Null while the role or credential is current. positionGroups: type: - array - 'null' description: Work history grouped by company, most recent first. items: type: - object - 'null' additionalProperties: true properties: company: type: - object - 'null' additionalProperties: true properties: id: type: - string - 'null' name: type: - string - 'null' logo: type: - string - 'null' url: type: - string - 'null' employees: type: - object - 'null' additionalProperties: true properties: start: type: - integer - 'null' end: type: - integer - 'null' date: type: - object - 'null' additionalProperties: true properties: start: type: - string - 'null' end: type: - string - 'null' description: Null while the role or credential is current. profilePositions: type: - array - 'null' items: type: - object - 'null' additionalProperties: true properties: company: type: - string - 'null' description: type: - string - 'null' title: type: - string - 'null' employmentType: type: - string - 'null' location: type: - string - 'null' date: type: - object - 'null' additionalProperties: true properties: start: type: - string - 'null' end: type: - string - 'null' description: Null while the role or credential is current. skills: type: - array - 'null' items: type: string memberBadges: type: - object - 'null' additionalProperties: true properties: premium: type: - boolean - 'null' creator: type: - boolean - 'null' openToWork: type: - boolean - 'null' hiring: type: - boolean - 'null' verified: type: - boolean - 'null' influencer: type: - boolean - 'null' statistics: type: - object - 'null' additionalProperties: true properties: network: type: - object - 'null' additionalProperties: true properties: influencer: type: - boolean - 'null' followable: {} followersCount: type: - integer - 'null' connectionsCount: type: - integer - 'null' experience: type: - object - 'null' additionalProperties: true properties: prevJobTitles: {} tenure: type: - object - 'null' additionalProperties: true properties: company: type: - string - 'null' start: type: - string - 'null' title: type: - string - 'null' company: type: - object - 'null' additionalProperties: true description: Current company. properties: id: type: - string - 'null' summary: type: - object - 'null' additionalProperties: true properties: name: type: - string - 'null' legalName: type: - string - 'null' description: type: - string - 'null' foundedYear: type: - integer - 'null' type: type: - string - 'null' industry: type: - string - 'null' staff: type: - object - 'null' additionalProperties: true properties: total: type: - integer - 'null' range: type: - object - 'null' additionalProperties: true properties: start: type: - integer - 'null' end: type: - integer - 'null' logo: type: - object - 'null' additionalProperties: true properties: source: type: - string - 'null' link: type: - object - 'null' additionalProperties: true properties: website: type: - string - 'null' domain: type: - string - 'null' linkedin: type: - string - 'null' crunchbase: type: - string - 'null' financial: type: - object - 'null' additionalProperties: true properties: revenue: type: - object - 'null' additionalProperties: true properties: annual: type: - object - 'null' additionalProperties: true properties: start: type: - integer - 'null' end: type: - integer - 'null' amount: type: - string - 'null' location: type: - object - 'null' additionalProperties: true properties: headquarter: type: - object - 'null' additionalProperties: true properties: continent: type: - string - 'null' country: type: - string - 'null' state: type: - string - 'null' city: type: - string - 'null' postalCode: type: - string - 'null' rawAddress: type: - string - 'null' position: type: - object - 'null' additionalProperties: true properties: lng: type: - number - 'null' lat: type: - number - 'null' locations: type: - array - 'null' items: type: - object - 'null' additionalProperties: true properties: continent: type: - string - 'null' country: type: - string - 'null' state: type: - string - 'null' city: type: - string - 'null' postalCode: type: - string - 'null' rawAddress: type: - string - 'null' position: type: - object - 'null' additionalProperties: true properties: lng: type: - number - 'null' lat: type: - number - 'null' technologies: type: - array - 'null' items: type: - object - 'null' additionalProperties: true properties: name: type: - string - 'null' category: type: - string - 'null' industries: type: - array - 'null' items: type: string languages: type: - array - 'null' items: type: string lastUpdated: type: - string - 'null' department: type: - object - 'null' additionalProperties: true properties: departments: type: - array - 'null' items: type: string subDepartments: type: - array - 'null' items: type: string functions: type: - array - 'null' items: type: string seniority: type: - string - 'null' lastUpdated: type: - string - 'null' description: >- A reverse-lookup person record with nested camelCase keys. Names are under profile (profile.firstName), not at the top level. Fields vary per record and may be null; records can include fields not listed here. VariablePersonProfile: type: object additionalProperties: true description: >- A flat person profile. Field types can vary by data source; check for missing or null values before using them. List sections are paginated objects with totalElements, page, size, and contents. properties: url: type: - string - 'null' identifier: type: - string - 'null' entityUrn: description: Profile URN, when available. objectUrn: description: Numeric profile identifier, when available. firstname: description: First name, when available. lastname: description: Last name, when available. middleName: description: Middle name, when available. birthDate: description: Birth date, when public. headline: description: Profile headline, when available. summary: description: Profile summary, when available. picture: description: Profile picture URL, when available. background: description: Background image URL, when available. industry: description: Industry, when available. openToWork: description: Open-to-work badge, when available. influencer: description: Influencer badge, when available. premium: description: Premium badge, when available. creator: description: Creator badge, when available. hiring: description: Hiring badge, when available. verified: description: Verified badge, when available. location: description: Location information, when available. properties: country: type: - string - 'null' city: type: - string - 'null' state: type: - string - 'null' defaultValue: type: - string - 'null' description: Full location text. shortValue: type: - string - 'null' description: Short location text. positionGroups: description: Work history grouped by company, most recent first. properties: totalElements: {} page: {} size: {} contents: type: array items: properties: company: properties: id: {} name: {} logo: {} url: {} domain: {} profileType: {} date: properties: start: {} end: {} profilePositions: type: array items: properties: company: {} description: {} title: {} employmentType: {} location: {} date: properties: start: {} end: {} educations: description: Paginated list section, when available. properties: totalElements: {} page: {} size: {} contents: type: array items: properties: school: properties: id: {} name: {} logo: {} url: {} profileType: {} degreeName: {} fieldOfStudy: {} grade: {} date: properties: start: {} end: {} certifications: description: Paginated list section, when available. properties: totalElements: {} page: {} size: {} contents: type: array items: properties: name: {} authority: {} url: {} licenseNumber: {} displaySource: {} company: properties: id: {} name: {} logo: {} url: {} profileType: {} date: properties: start: {} end: {} languages: description: Paginated list section, when available. properties: totalElements: {} page: {} size: {} contents: type: array items: properties: name: {} proficiency: {} skills: description: Paginated list section, when available. properties: totalElements: {} page: {} size: {} contents: type: array items: type: string organizations: description: Paginated list section, when available. properties: totalElements: {} page: {} size: {} contents: type: array items: {} patents: description: Paginated list section, when available. properties: totalElements: {} page: {} size: {} contents: type: array items: {} awards: description: Paginated list section, when available. properties: totalElements: {} page: {} size: {} contents: type: array items: {} projects: description: Paginated list section, when available. properties: totalElements: {} page: {} size: {} contents: type: array items: {} publications: description: Paginated list section, when available. properties: totalElements: {} page: {} size: {} contents: type: array items: {} courses: description: Paginated list section, when available. properties: totalElements: {} page: {} size: {} contents: type: array items: {} testScores: description: Paginated list section, when available. properties: totalElements: {} page: {} size: {} contents: type: array items: {} volunteerExperiences: description: Paginated list section, when available. properties: totalElements: {} page: {} size: {} contents: type: array items: {} profile: description: Additional profile data, when available. link: description: Profile links, when available. NotFoundStatus: type: object required: - status additionalProperties: false properties: status: type: string const: not_found Error: type: object additionalProperties: true properties: error: type: string message: type: string responses: Unauthorized: description: The Bearer token is missing or invalid. content: application/json: schema: $ref: '#/components/schemas/Error' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API key description: >- Use an Airscale workspace API key. Never expose the key in client-side code. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.