Reverse email

Find a profile from an email

curl --request POST \
  --url https://api.airscale.io/v1/reverse-email \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": " Example.Person@Example.Org "
}
'

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

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-email"

payload = { "email": " Example.Person@Example.Org " }
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"
}

POST

reverse-email

Find a profile from an email

curl --request POST \
  --url https://api.airscale.io/v1/reverse-email \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "email": " Example.Person@Example.Org "
}
'

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

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-email"

payload = { "email": " Example.Person@Example.Org " }
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"
}

Submit an email address and receive the matching person profile when one can be resolved.

The limit is 25 requests per second per workspace. A returned profile costs 2 credits. A miss returns the JSON string "not found", not an object with a status field, and is not charged.

After a 429 Too Many Requests response, retry in a later second with bounded exponential backoff. A 503 response is not charged. Retry the same email with increasing delays and a fixed retry limit; contact support if errors persist.

Read the profile

A match returns a nested person record with camelCase keys. The name is under profile (profile.firstName, profile.lastName, profile.headline), not at the top level. The LinkedIn URL is in url and link.linkedin, work history is positionGroups, and the current employer is company (company.summary.name, company.link.domain). Fields can be null or absent. When the match comes from a fallback lookup, the record uses the flat fields of People profile instead, or contains only url and identifier.

Next step

Use Reverse phone when a phone number is the identifier you have for a person.

Authorizations

Authorization

string

header

required

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

Body

application/json

The email is trimmed and lowercased before lookup. It must have a non-empty local part, an @ sign, and a domain containing a dot.

string

required

Pattern: ^\s*[^\s@]+@[^\s@]+\.[^\s@]+\s*$

Response

A public person profile or the exact JSON string "not found".

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.

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