---
updatedAt: 2026-06-04T10:32:52.000Z
agentTools:
  projectIndex: https://docs.companyenrich.com/llms.txt
---

# Email (BETA)

**BETA:** This endpoint is currently in beta and may change based on provider coverage and response tuning.

**Cost:** 10 credits per newly accessed found email

Resolves a work email address for a single person on a specific domain.

If `domain` is omitted, current experience domains are tried automatically in seniority order.
If `domain` is provided, it must match one of the person's experiences.

The response does not expose provider details. It returns a person summary, the selected domain, and a status of `pending`, `found`, `not-found`, or `unavailable`.
When the lookup completes successfully, the response also includes the resolved email and certainty value.

# OpenAPI definition

````json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Company Enrich API",
    "description": "The Company Enrich API provides programmatic access to a comprehensive database of company and person data for enrichment, search, and lead generation.\n\n## Key Features\n\n- **Company Enrichment** — Enrich company profiles by domain, ID, or matching properties. Supports single lookups, batch requests, and bulk background jobs.\n- **Company Search** — Search and filter companies by industry, location, size, technology usage, keywords, and more. Supports page-based, cursor-based, and async export pagination.\n- **People Search** — Search for professionals by job title, company, location, and other criteria. Export results in CSV or JSON.\n- **Similar Companies** — Find companies similar to a given company based on shared attributes.\n- **Company Lists** — Create and manage saved lists of companies for organizing and exporting your data.\n\n## Authentication\n\nAll API requests require a Bearer token passed in the `Authorization` header:\n\n```\nAuthorization: Bearer YOUR_API_TOKEN\n```\n\nYou can generate API tokens from your [dashboard](https://companyenrich.com/dashboard).\n\n## Credits\n\nMost API calls consume credits. The credit cost for each endpoint is documented in its description. You can check your remaining credit balance using the User endpoint.\n\n## Rate Limiting\n\nThe global API limiter allows **500 requests per minute** per IP address. Authenticated API routes also use a per-user route limiter based on plan capabilities.\nSupplementary lookup endpoints (such as keyword/technology/industry autocompletes) use a separate per-user route-level bucket.",
    "termsOfService": "https://companyenrich.com/terms-and-conditions",
    "contact": {
      "url": "https://companyenrich.com/",
      "email": "support@companyenrich.com"
    },
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://api.companyenrich.com"
    }
  ],
  "paths": {
    "/people/email": {
      "get": {
        "tags": [
          "People / Enrichment"
        ],
        "summary": "Email (BETA)",
        "description": "**BETA:** This endpoint is currently in beta and may change based on provider coverage and response tuning.\n\n**Cost:** 10 credits per newly accessed found email\n\nResolves a work email address for a single person on a specific domain.\n\nIf `domain` is omitted, current experience domains are tried automatically in seniority order.\nIf `domain` is provided, it must match one of the person's experiences.\n\nThe response does not expose provider details. It returns a person summary, the selected domain, and a status of `pending`, `found`, `not-found`, or `unavailable`.\nWhen the lookup completes successfully, the response also includes the resolved email and certainty value.",
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "description": "The CompanyEnrich person ID.",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "domain",
            "in": "query",
            "description": "Optional company domain to resolve the email address on. If omitted, current experience domains are tried in seniority order.",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonEmailEnrichmentResponse"
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "402": {
            "description": "Payment Required",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "404": {
            "description": "Not Found",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          },
          "422": {
            "description": "Unprocessable Entity",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/HttpValidationProblemDetails"
                }
              }
            }
          },
          "429": {
            "description": "Too Many Requests",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/ProblemDetails"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "HttpValidationProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "nullable": true
          },
          "errors": {
            "type": "object",
            "additionalProperties": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      },
      "NullableOfPersonDepartment": {
        "enum": [
          "c-suite",
          "c-suite/executive",
          "c-suite/finance-executive",
          "c-suite/founder",
          "c-suite/human-resources-executive",
          "c-suite/information-technology-executive",
          "c-suite/legal-executive",
          "c-suite/marketing-executive",
          "c-suite/medical-health-executive",
          "c-suite/operations-executive",
          "c-suite/sales-executive",
          "product-management",
          "product-management/product-development",
          "product-management/product-management",
          "engineering-technical",
          "engineering-technical/artificial-intelligence-machine-learning",
          "engineering-technical/bioengineering",
          "engineering-technical/biometrics",
          "engineering-technical/business-intelligence",
          "engineering-technical/chemical-engineering",
          "engineering-technical/cloud-mobility",
          "engineering-technical/data-science",
          "engineering-technical/devops",
          "engineering-technical/digital-transformation",
          "engineering-technical/emerging-technology-innovation",
          "engineering-technical/engineering-technical",
          "engineering-technical/industrial-engineering",
          "engineering-technical/mechanic",
          "engineering-technical/mobile-development",
          "engineering-technical/project-management",
          "engineering-technical/research-development",
          "engineering-technical/scrum-master-agile-coach",
          "engineering-technical/software-development",
          "engineering-technical/support-technical-services",
          "engineering-technical/technician",
          "engineering-technical/technology-operations",
          "engineering-technical/test-quality-assurance",
          "engineering-technical/ui-ux",
          "engineering-technical/web-development",
          "design",
          "design/all-design",
          "design/product-ui-ux-design",
          "design/graphic-design",
          "education",
          "education/teacher",
          "education/principal",
          "education/superintendent",
          "education/professor",
          "finance",
          "finance/accounting",
          "finance/finance",
          "finance/financial-planning-analysis",
          "finance/financial-reporting",
          "finance/financial-strategy",
          "finance/financial-systems",
          "finance/internal-audit-control",
          "finance/investor-relations",
          "finance/mergers-acquisitions",
          "finance/real-estate-finance",
          "finance/financial-risk",
          "finance/shared-services",
          "finance/sourcing-procurement",
          "finance/tax",
          "finance/treasury",
          "human-resources",
          "human-resources/compensation-benefits",
          "human-resources/culture-diversity-inclusion",
          "human-resources/employee-labor-relations",
          "human-resources/health-safety",
          "human-resources/human-resource-information-system",
          "human-resources/human-resources",
          "human-resources/hr-business-partner",
          "human-resources/learning-development",
          "human-resources/organizational-development",
          "human-resources/recruiting-talent-acquisition",
          "human-resources/talent-management",
          "human-resources/workforce-management",
          "human-resources/people-operations",
          "information-technology",
          "information-technology/application-development",
          "information-technology/business-service-management-itsm",
          "information-technology/collaboration-web-app",
          "information-technology/data-center",
          "information-technology/data-warehouse",
          "information-technology/database-administration",
          "information-technology/ecommerce-development",
          "information-technology/enterprise-architecture",
          "information-technology/help-desk-desktop-services",
          "information-technology/hr-financial-erp-systems",
          "information-technology/information-security",
          "information-technology/information-technology",
          "information-technology/infrastructure",
          "information-technology/it-asset-management",
          "information-technology/it-audit-it-compliance",
          "information-technology/it-operations",
          "information-technology/it-procurement",
          "information-technology/it-strategy",
          "information-technology/it-training",
          "information-technology/networking",
          "information-technology/project-program-management",
          "information-technology/quality-assurance",
          "information-technology/retail-store-systems",
          "information-technology/servers",
          "information-technology/storage-disaster-recovery",
          "information-technology/telecommunications",
          "information-technology/virtualization",
          "legal",
          "legal/acquisitions",
          "legal/compliance",
          "legal/contracts",
          "legal/corporate-secretary",
          "legal/ediscovery",
          "legal/ethics",
          "legal/governance",
          "legal/governmental-affairs-regulatory-law",
          "legal/intellectual-property-patent",
          "legal/labor-employment",
          "legal/lawyer-attorney",
          "legal/legal",
          "legal/legal-counsel",
          "legal/legal-operations",
          "legal/litigation",
          "legal/privacy",
          "marketing",
          "marketing/advertising",
          "marketing/brand-management",
          "marketing/content-marketing",
          "marketing/customer-experience",
          "marketing/customer-marketing",
          "marketing/demand-generation",
          "marketing/digital-marketing",
          "marketing/ecommerce-marketing",
          "marketing/event-marketing",
          "marketing/field-marketing",
          "marketing/lead-generation",
          "marketing/marketing",
          "marketing/marketing-analytics-insights",
          "marketing/marketing-communications",
          "marketing/marketing-operations",
          "marketing/product-marketing",
          "marketing/public-relations",
          "marketing/search-engine-optimization-pay-per-click",
          "marketing/social-media-marketing",
          "marketing/strategic-communications",
          "marketing/technical-marketing",
          "medical-health",
          "medical-health/anesthesiology",
          "medical-health/chiropractics",
          "medical-health/clinical-systems",
          "medical-health/dentistry",
          "medical-health/dermatology",
          "medical-health/doctors-physicians",
          "medical-health/epidemiology",
          "medical-health/first-responder",
          "medical-health/infectious-disease",
          "medical-health/medical-administration",
          "medical-health/medical-education-training",
          "medical-health/medical-research",
          "medical-health/medicine",
          "medical-health/neurology",
          "medical-health/nursing",
          "medical-health/nutrition-dietetics",
          "medical-health/obstetrics-gynecology",
          "medical-health/oncology",
          "medical-health/opthalmology",
          "medical-health/optometry",
          "medical-health/orthopedics",
          "medical-health/pathology",
          "medical-health/pediatrics",
          "medical-health/pharmacy",
          "medical-health/physical-therapy",
          "medical-health/psychiatry",
          "medical-health/psychology",
          "medical-health/public-health",
          "medical-health/radiology",
          "medical-health/social-work",
          "operations",
          "operations/call-center",
          "operations/construction",
          "operations/corporate-strategy",
          "operations/customer-service-support",
          "operations/enterprise-resource-planning",
          "operations/facilities-management",
          "operations/leasing",
          "operations/logistics",
          "operations/office-operations",
          "operations/operations",
          "operations/physical-security",
          "operations/project-development",
          "operations/quality-management",
          "operations/real-estate",
          "operations/safety",
          "operations/store-operations",
          "operations/supply-chain",
          "sales",
          "sales/account-management",
          "sales/business-development",
          "sales/channel-sales",
          "sales/customer-retention-development",
          "sales/customer-success",
          "sales/field-outside-sales",
          "sales/inside-sales",
          "sales/partnerships",
          "sales/revenue-operations",
          "sales/sales",
          "sales/sales-enablement",
          "sales/sales-engineering",
          "sales/sales-operations",
          "sales/sales-training",
          "consulting",
          "consulting/consultant",
          null
        ],
        "description": "The department of the person",
        "nullable": true
      },
      "NullableOfPersonSeniority": {
        "enum": [
          "owner",
          "founder",
          "c-suite",
          "partner",
          "vp",
          "head",
          "director",
          "manager",
          "senior",
          "entry",
          "intern",
          null
        ],
        "description": "The seniority level of the person",
        "nullable": true
      },
      "PersonEmailCertainty": {
        "enum": [
          "unknown",
          "medium",
          "high",
          "very-high"
        ],
        "description": "Normalized certainty value. One of: unknown, medium, high, very-high."
      },
      "PersonEmailEnrichmentResponse": {
        "required": [
          "person",
          "person_id",
          "domain",
          "status",
          "certainty"
        ],
        "type": "object",
        "properties": {
          "person": {
            "$ref": "#/components/schemas/PersonSummary"
          },
          "person_id": {
            "type": "integer",
            "description": "The CompanyEnrich person ID used for the lookup.",
            "format": "int64"
          },
          "domain": {
            "type": "string",
            "description": "The normalized registrable domain selected for the response. When `domain` is omitted, the endpoint tries current experience domains ordered by seniority and returns the domain associated with the selected lookup result."
          },
          "status": {
            "$ref": "#/components/schemas/PersonEmailEnrichmentResponseStatus"
          },
          "email": {
            "type": "string",
            "description": "The resolved work email address when the lookup succeeds.",
            "nullable": true
          },
          "certainty": {
            "$ref": "#/components/schemas/PersonEmailCertainty"
          }
        }
      },
      "PersonEmailEnrichmentResponseStatus": {
        "enum": [
          "pending",
          "found",
          "not-found",
          "unavailable"
        ],
        "description": "Lookup status. One of: pending, found, not-found, unavailable."
      },
      "PersonSummary": {
        "required": [
          "id"
        ],
        "type": "object",
        "properties": {
          "id": {
            "type": "integer",
            "description": "The unique identifier of the person",
            "format": "int64"
          },
          "name": {
            "maxLength": 1024,
            "type": "string",
            "description": "The full name of the person",
            "nullable": true
          },
          "position": {
            "type": "string",
            "description": "The job position/title of the person",
            "nullable": true
          },
          "seniority": {
            "$ref": "#/components/schemas/NullableOfPersonSeniority"
          },
          "department": {
            "$ref": "#/components/schemas/NullableOfPersonDepartment"
          },
          "image_url": {
            "type": "string",
            "description": "The image URL of the person",
            "nullable": true
          }
        },
        "description": "Summary information for the resolved person."
      },
      "ProblemDetails": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "nullable": true
          },
          "title": {
            "type": "string",
            "nullable": true
          },
          "status": {
            "type": "integer",
            "format": "int32",
            "nullable": true
          },
          "detail": {
            "type": "string",
            "nullable": true
          },
          "instance": {
            "type": "string",
            "nullable": true
          }
        }
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "apiKey",
        "description": "API Token used for authentication. Example: \"Authorization: Bearer {token}\"",
        "name": "Authorization",
        "in": "header",
        "x-bearer-format": "bearer"
      }
    }
  },
  "security": [
    {
      "Bearer": []
    }
  ],
  "tags": [
    {
      "name": "People / Enrichment",
      "description": "Resolve work email addresses for individual people in realtime or background jobs. The realtime and bulk email enrichment endpoints are currently in beta."
    }
  ]
}
````