---
title: "Reverse lookup an email"
method: GET
path: "/api/v1/enrichment/reverse-email"
tags: ["Enrichment"]
---

# Reverse lookup an email

`GET /api/v1/enrichment/reverse-email`

## Request

- Base URL: `https://api.rodz.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.rodz.io/api/v1/enrichment/reverse-email`
- Auth: HTTP bearer

Identify who is behind an email address by retrieving their complete LinkedIn professional profile — useful for lead qualification, CRM enrichment, and sales intelligence.

**Input:** `email` (the email address to look up), plus optional `firstName`, `lastName`, or `fullName` to improve matching accuracy.

**Output:** The matched person's full LinkedIn profile data in `data.person` (including name, LinkedIn URL and ID, headline, current company, location, connections count, education, work history, skills, photo URL, and more), or null if no match is found. Successfully matched results are billed at 0.5 credits per call.

## Query parameters

- `email` string, required: Contact email address
- `firstName` string, nullable: First name
- `lastName` string, nullable: Last name
- `fullName` string, nullable: Full name

## Response `200`

Matched person (`data.person`).

- object: Typed response for ``GET /enrichment/reverse-email``.
  - `data` object, nullable: ``data`` wrapper for the person endpoints — holds a single ``person``.
    - `person` object, nullable: The enriched LinkedIn person object (``data.person``).
      - `firstName` string, nullable
      - `middleName` string, nullable
      - `lastName` string, nullable
      - `name` string, nullable
      - `linkedInUrl` string, nullable
      - `linkedInId` string, nullable
      - `linkedinSalesLink` string, nullable: Sales Navigator profile URN token (e.g. ACoAAB...)
      - `headline` string, nullable
      - `activeCompany` string, nullable
      - `numberOfCurrentCompanies` string, nullable
      - `location` string, nullable
      - `country` string, nullable
      - `region` string, nullable
      - `county` string, nullable
      - `city` string, nullable
      - `followers` string, nullable: Follower count as a string
      - `followerCount` integer, nullable
      - `connectionsCount` integer, nullable
      - `isCreator` boolean, nullable
      - `isJobSeeker` boolean, nullable
      - `isOpenLink` boolean, nullable
      - `isPremium` boolean, nullable
      - `isVerified` boolean, nullable
      - `openProfileMessages` boolean, nullable
      - `languages` string, nullable: Comma-separated language list
      - `skillsList` string, nullable: Comma-separated skills
      - `linkedinSummary` string, nullable
      - `companyWebsite` string, nullable
      - `extractedGender` string, nullable: Inferred gender when available: one of "male", "female", or "" (unknown)
      - `formerCompaniesList` string, nullable: Comma-separated former company names
      - `education` object, nullable
        - `universitiesNamesList` string, nullable
        - `educationDetails` object[], nullable
          - `startedOn` object, nullable: Start year. Education dates are year-granular; no month is available.
            - `year` string, nullable
          - `endedOn` object, nullable: End year. Year-granular, like startedOn.
            - `year` string, nullable
          - `universityName` string, nullable
          - `fieldsOfStudy` string[], nullable
          - `socialUrl` string, nullable: School LinkedIn URL, e.g. https://www.linkedin.com/company/15142508/
          - `schoolId` string, nullable: LinkedIn school ID as a string, e.g. "15142508"
          - `schoolLogo` string, nullable: School logo image URL (empty when the school has none)
      - `certificationsList` string, nullable
      - `certification` object[], nullable: Certification entries (empty when none)
        - `title` string, nullable: Certification name, e.g. "Machine Learning"
        - `issuedAt` string, nullable: Free text as displayed, e.g. "Issued Jan 2017" — not a date
        - `link` string, nullable: URL of the certification itself
        - `issuedBy` string, nullable: Issuing organisation name
        - `issuedByLink` string, nullable: LinkedIn URL of the issuing organisation
        - `issuedByLogo` object, nullable
          - `url` string, nullable
          - `sizes` object[], nullable
            - `url` string, nullable
            - `width` integer, nullable
            - `height` integer, nullable
      - `currentCompanyDetail` object[], nullable
        - `companyName` string, nullable
        - `jobTitle` string, nullable
        - `startTime` string, nullable
        - `endTime` string, nullable: End date, or "Present" for current roles
        - `yearsInCompany` string, nullable
        - `yearsInRole` string, nullable
        - `jobDescription` string, nullable
        - `companyUrl` string, nullable: Company LinkedIn URL for this position
        - `companyWebsite` string, nullable
        - `companyId` string, nullable: LinkedIn company ID as a string, e.g. "101088054"
        - `companyLogo` string, nullable: Company logo image URL (empty when unavailable)
        - `location` string, nullable: Where this role is based, e.g. "Bordeaux, Nouvelle-Aquitaine, France"
        - `employmentType` string, nullable: Contract type as shown on the profile, e.g. "Permanent", "Internship"
        - `workplaceType` string, nullable: Work arrangement, e.g. "Hybrid", "Remote", "On-site"
      - `pastCompaniesDetails` object[], nullable
        - `companyName` string, nullable
        - `jobTitle` string, nullable
        - `startTime` string, nullable
        - `endTime` string, nullable: End date, or "Present" for current roles
        - `yearsInCompany` string, nullable
        - `yearsInRole` string, nullable
        - `jobDescription` string, nullable
        - `companyUrl` string, nullable: Company LinkedIn URL for this position
        - `companyWebsite` string, nullable
        - `companyId` string, nullable: LinkedIn company ID as a string, e.g. "101088054"
        - `companyLogo` string, nullable: Company logo image URL (empty when unavailable)
        - `location` string, nullable: Where this role is based, e.g. "Bordeaux, Nouvelle-Aquitaine, France"
        - `employmentType` string, nullable: Contract type as shown on the profile, e.g. "Permanent", "Internship"
        - `workplaceType` string, nullable: Work arrangement, e.g. "Hybrid", "Remote", "On-site"
      - `photoUrl` string, nullable
      - `websites` string, nullable: Comma-separated personal website URLs
      - `hiring` boolean, nullable
      - `registeredAt` string, nullable: LinkedIn registration date (YYYY-MM-DD)
      - `locale` string, nullable: Profile locale, e.g. "en", "fr"
  - `requestId` string, nullable: Unique request identifier

## Other responses

- `422`: Validation Error
- `429`: Rate limit exceeded. Retry after the number of seconds in the `Retry-After` response header.

---

[API](https://skmtc.dev/rodz/apis/rodz-api.md) · [All operations](https://skmtc.dev/rodz/apis/rodz-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rodz/apis/rodz-api/revisions/3003505ff896?raw)