> ## 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.

# Email to MAID

> The Email to MAID API resolves an email address to one or more Mobile Advertising IDs (MAIDs), including AAIDs (Android Advertising IDs) and IDFAs (Apple Identifiers for Advertisers).

MAIDs are what ad platforms use to target users on their mobile devices with precision. Use this endpoint to connect a known email identity to mobile device signals, enabling cross-device retargeting, programmatic audience activation, and mobile-first ad campaigns against your contact lists.

**Use this endpoint to:**
- Build mobile retargeting audiences from your contact list
- Activate programmatic ad campaigns against known contacts
- Connect email identities to mobile device signals for cross-device targeting

**Fair Use Policy:**
This API is subject to our <a href="https://moltsets.com/fair-use-policy-enrichment/" target="_blank" rel="noopener">Fair Use Policy for Enrichment</a>.



## OpenAPI

````yaml /openapi.json post /email_to_maid
openapi: 3.1.0
info:
  title: MoltSets API
  version: 1.0.0
  description: >-
    MoltSets is an identity resolution API. Use it to resolve emails, LinkedIn
    profiles, and IP addresses into enriched contact and company data, including
    business and personal emails, mobile phone numbers, and firmographic
    details.
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:
  /email_to_maid:
    post:
      tags:
        - Get Ad Audience
      summary: Email to MAID
      description: >-
        The Email to MAID API resolves an email address to one or more Mobile
        Advertising IDs (MAIDs), including AAIDs (Android Advertising IDs) and
        IDFAs (Apple Identifiers for Advertisers).


        MAIDs are what ad platforms use to target users on their mobile devices
        with precision. Use this endpoint to connect a known email identity to
        mobile device signals, enabling cross-device retargeting, programmatic
        audience activation, and mobile-first ad campaigns against your contact
        lists.


        **Use this endpoint to:**

        - Build mobile retargeting audiences from your contact list

        - Activate programmatic ad campaigns against known contacts

        - Connect email identities to mobile device signals for cross-device
        targeting


        **Fair Use Policy:**

        This API is subject to our <a
        href="https://moltsets.com/fair-use-policy-enrichment/" target="_blank"
        rel="noopener">Fair Use Policy for Enrichment</a>.
      operationId: hemToMaid
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                email:
                  type: string
                  description: Email address.
            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:
                      - device_id: b8c747bb-96c5-453f-b770-9d64889XXXXX
                        device_type: AAID
                    status: ok
                    metadata:
                      fair_use:
                        records_remaining_5h: 179999
                        records_reset_5h: '2026-07-15T18:53:16Z'
                        records_remaining_1w: 899999
                        records_reset_1w: '2026-07-22T13:53:16Z'
                      external_tokens_used: 0
                      external_tokens_remaining: 5000
        '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`.

````