> ## Documentation Index > Fetch the complete documentation index at: https://docs.companyenrich.com/llms.txt > Use this file to discover all available pages before exploring further. # Email > **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 ````yaml openapi/v1.json GET /people/email openapi: 3.0.4 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. ## Key Features - **Company Enrichment** — Enrich company profiles by domain, ID, or matching properties. Supports single lookups, batch requests, and bulk background jobs. - **Company Search** — Search and filter companies by industry, location, size, technology usage, keywords, and more. Supports page-based, cursor-based, and async export pagination. - **People Search** — Search for professionals by job title, company, location, and other criteria. Export results in CSV or JSON. - **Similar Companies** — Find companies similar to a given company based on shared attributes. - **Company Lists** — Create and manage saved lists of companies for organizing and exporting your data. ## Authentication All API requests require a Bearer token passed in the `Authorization` header: ``` Authorization: Bearer YOUR_API_TOKEN ``` You can generate API tokens from your [dashboard](https://companyenrich.com/dashboard). ## Credits Most 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. ## Rate Limiting The 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. Supplementary 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 security: - Bearer: [] tags: - name: Company / Enrichment description: >- Enrich company data by domain, properties, or in batch. Get company details by ID. - name: Company / Bulk Enrichment description: >- Create and manage asynchronous bulk enrichment jobs for large domain lists. - name: Company / Search description: Search companies by filters with pagination and cursor scrolling. - name: Company / Export description: Create and manage asynchronous company search export jobs. - name: Company / Similar description: Find companies similar to a given company by domain or ID. - name: People / Search description: >- Search people by various criteria with page-based or cursor-based pagination. - name: People / Enrichment description: >- Resolve work email addresses for individual people in realtime or background jobs. - name: People / Export description: Create and manage asynchronous people search export jobs. - name: Jobs description: >- Endpoints for listing and monitoring background processing jobs such as bulk enrichments and async exports. - name: Company / Lists description: Endpoints for creating and managing company lists and export lists. - name: Geo description: >- Endpoints for looking up geographic data including regions, countries, states, and cities. - name: Industries description: >- Endpoints for listing available industry classifications used in company search filters. - name: Keywords description: Endpoints for looking up keywords used in company search filters. - name: Technologies description: Endpoints for looking up technologies used in company search filters. - name: User description: >- Endpoints for retrieving information about the authenticated user, including credit balance and account details. - name: Positions description: >- Endpoints for looking up job positions and titles used in people search filters. paths: /people/email: get: tags: - People / Enrichment summary: Email description: >- **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. 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: 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' 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 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 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. PersonEmailEnrichmentResponseStatus: enum: - pending - found - not-found - unavailable description: 'Lookup status. One of: pending, found, not-found, unavailable.' PersonEmailCertainty: enum: - unknown - medium - high - very-high description: 'Normalized certainty value. One of: unknown, medium, high, very-high.' NullableOfPersonSeniority: enum: - owner - founder - c-suite - partner - vp - head - director - manager - senior - entry - intern - null description: The seniority level of the person nullable: true 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 securitySchemes: Bearer: type: apiKey description: >- API Token used for authentication. Example: "Authorization: Bearer {token}" name: Authorization in: header x-bearer-format: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.