> ## Documentation Index
> Fetch the complete documentation index at: https://developer.moltsets.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Reverse Email Lookup

> Resolve an email address into a complete business profile, including full name, job title, seniority, company, LinkedIn URL, firmographic data, and additional email addresses on file. Use this to enrich inbound leads, form fills, or email list records with everything you need to qualify and contact a prospect. Set `include_mobile_phone: true` to also return a carrier-verified mobile number when available; external credits apply when phone data is found.



## OpenAPI

````yaml /openapi.json post /reverse_email_lookup
openapi: 3.1.0
info:
  title: MoltSets API
  version: 1.0.0
  description: >-
    Identity resolution API. Resolve emails, LinkedIn profiles, IP addresses,
    and emails into enriched contact and company data.
servers:
  - url: https://api.moltsets.com/api/v1/tools
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Search
    description: >-
      Search and filter company and business profiles by name, domain, industry,
      size, or revenue.
  - name: Get Valid Emails
    description: Resolve and enrich valid business and personal email addresses.
  - name: Get Carrier-Verified Mobile Phones
    description: Enrich carrier-verified mobile phone numbers.
  - name: Get Full Business Profile
    description: Resolve identifiers to full business profiles and company firmographics.
  - name: Get Ad Audience
    description: >-
      Resolve identifiers to hashed email (HEM) and mobile advertising IDs
      (MAIDs) for audience matching.
  - name: Get Company
    description: Resolve IP addresses to company data.
  - name: Account
    description: Account management tools. Free — do not consume credits.
paths:
  /reverse_email_lookup:
    post:
      tags:
        - Reverse Lookups
      summary: Reverse Email Lookup
      description: >-
        Resolve an email address into a complete business profile, including
        full name, job title, seniority, company, LinkedIn URL, firmographic
        data, and additional email addresses on file. Use this to enrich inbound
        leads, form fills, or email list records with everything you need to
        qualify and contact a prospect. Set `include_mobile_phone: true` to also
        return a carrier-verified mobile number when available; external credits
        apply when phone data is found.
      operationId: hemToBusinessProfile
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                email:
                  type: string
                  description: Email address.
                include_mobile_phone:
                  type: boolean
                  default: false
                  description: >-
                    When true, attempts to include mobile phone. Costs external
                    credits when data is found.
            examples:
              email:
                summary: Using email
                value:
                  email: john.smith@example.com
      responses:
        '200':
          description: Success
          content:
            application/json:
              examples:
                found:
                  summary: Data found
                  value:
                    results:
                      first_name: John
                      last_name: Smith
                      title: Principal Cybersecurity Engineer
                      seniority: Manager
                      functional_area: Information Technology
                      linkedinurl: https://www.linkedin.com/in/john-smith-123
                      current_company: MoltSets
                      current_company_url: https://moltsets.com
                      current_company_linkedinurl: https://linkedin.com/company/moltsets
                      country: United States
                      company_employee_count: '3'
                      company_employee_range: 1-10
                      company_revenue: '1200000000'
                      company_revenue_range: $1-10M
                      work_email_confirmed: a4cd87c390c98385297fbe9250XXXXX
                      work_email_confirmed_status: '2025-10-12'
                      personal_emails:
                        - 3018fe3a783fad1db0370ee3fXXXXX
                      personal_emails_status:
                        - null
                    status: ok
                    metadata:
                      tokens_charged: 1
                      tokens_remaining: unlimited
                      daily_results_remaining: 9876
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorBadRequest'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorUnauthorized'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorNotFound'
        '422':
          description: Invalid Input
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorInvalidInput'
        '429':
          description: Rate limit exceeded
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorRateLimit'
components:
  schemas:
    ErrorBadRequest:
      type: object
      properties:
        error:
          type: string
          example: Bad Request
        message:
          type: string
          example: >-
            The server cannot process the request due to a client error (400 Bad
            Request).
    ErrorUnauthorized:
      type: object
      properties:
        error:
          type: string
          example: Unauthorized
        message:
          type: string
          example: Invalid API key.
    ErrorNotFound:
      type: object
      properties:
        error:
          type: string
          example: Not Found
        message:
          type: string
          example: No match was found for the data provided.
    ErrorInvalidInput:
      type: object
      properties:
        error:
          type: string
          example: Invalid Input
        message:
          type: string
          example: Message describing the nature of the invalid input.
    ErrorRateLimit:
      type: object
      properties:
        error:
          type: string
          example: Too Many Requests
        message:
          type: string
          example: Rate limit exceeded. Maximum 100 requests per second.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Pass your API key as a Bearer token. Keys follow the format
        `ms_XXXXXXXXXXX`.

````