Reverse phone

Find a profile from a phone number

curl --request POST \
  --url https://api.airscale.io/v1/reverse-phone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mobile_phone": "+12025550147"
}
'

const url = 'https://api.airscale.io/v1/reverse-phone';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({mobile_phone: '+12025550147'})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.airscale.io/v1/reverse-phone"

payload = { "mobile_phone": "+12025550147" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "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"
  }
}

POST

reverse-phone

Find a profile from a phone number

curl --request POST \
  --url https://api.airscale.io/v1/reverse-phone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mobile_phone": "+12025550147"
}
'

const url = 'https://api.airscale.io/v1/reverse-phone';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({mobile_phone: '+12025550147'})
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.airscale.io/v1/reverse-phone"

payload = { "mobile_phone": "+12025550147" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "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"
  }
}

Submit a phone number and receive the matching person profile when one can be resolved.

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, 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 instead.

Next step

Use People profile when you already have a professional profile URL and want the structured profile directly.

Authorizations

Authorization

string

header

required

Use an Airscale workspace API key. Never expose the key in client-side code.

Body

application/json

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.

mobile_phone

string

required

Minimum string length: 1

Pattern: ^(?!\s*(?:null|undefined)\s*$)(?=.*\S)[\s\S]+$

Response

A public person profile in a body envelope, or an exact not_found status.

Option 1
Option 2
Option 3

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.

body

object

required

A copy of the same profile object. It is kept at the top level too for existing integrations.

Option 1
Option 2

Show child attributes

string | null

Record identifier, when available.

identifier

string | null

Public profile identifier, when available.

url

string | null

Public profile URL, when available.

profile

object | null

Name, headline, and profile media.

Show child attributes

link

object | null

Public profile links.

Show child attributes

location

object | null

Person location.

Show child attributes

languages

object | null

Show child attributes

industry

string | null

educations

(object | null)[] | null

Show child attributes

certifications

(object | null)[] | null

Show child attributes

positionGroups

(object | null)[] | null

Work history grouped by company, most recent first.

Show child attributes

skills

string[] | null

memberBadges

object | null

Show child attributes

statistics

object | null

Show child attributes

company

object | null

Current company.

Show child attributes

department

object | null

Show child attributes

lastUpdated

string | null

Start here

Account

Search and discovery

Contact data

Profiles and reverse lookup

Post engagement

Intent signals

Miscellaneous

Table API

Read the profile

Next step

Authorizations

Body

Response

​Read the profile

​Next step

Authorizations

Body

Response

Read the profile

Next step