1. Email Finder
Enrich API
  • Introduction
  • Quickstart
  • API Reference
  • Credits & Pricing
  • Rate Limits
  • Authentication
  • Company Followers
    • Count Estimation
      • Start count estimation
      • Get estimation status/results
    • Start company follower scrape
      POST
    • Check scrape progress
      GET
    • Get scrape results
      GET
    • Export results as CSV
      GET
    • Check daily scraping limit
      GET
  • Email Validation
    • Validate a single email
      POST
    • Validate emails in batch
      POST
    • Check batch validation progress
      GET
    • Get batch validation results
      GET
  • Email Finder
    • Find a professional email
      POST
    • Find emails in batch
      POST
    • Check batch finder progress
      GET
    • Get batch finder results
      GET
  • Phone Finder
    • Find phone numbers
      GET
    • Find phone numbers in batch
      POST
    • Check bulk phone lookup progress
      GET
    • Get bulk phone lookup results
      GET
  • Reverse Email Lookup
    • Look up professional profiles in batch
      POST
    • Look up a professional profile by email
      POST
    • Check bulk lookup progress
      GET
    • Get bulk lookup results
      GET
  • Wallets
    • Get your credit balance
    • Get transaction history
  • Teams
    • List team members
    • Invite someone to your team
    • List pending invitations
    • Cancel a pending invitation
  • Webhooks
    • Email Validation: per-result callback
    • Email Validation: batch completion callback
    • Email Finder: per-result callback
    • Email Finder: batch completion callback
    • Phone Finder: per-result callback
    • Phone Finder: batch completion callback
    • Reverse Lookup: per-result callback
    • Reverse Lookup: batch completion callback
    • Company Followers: per-result callback
    • Company Followers: completion callback
  • Lead Finder
    • Search leads
    • Export leads to CSV (async)
    • Count matching leads
    • Reveal contact info
    • Enrich contacts with specific fields
    • Unlock full last names
    • List saved searches
    • Save a search
    • Delete a saved search
    • Get filter options
    • Suggest company names
    • Poll reveal/enrich job
    • List reveal/enrich jobs
    • List export jobs
    • Poll export job status
    • Download export CSV
  • People Search
    • Cascading ICP people search
    • Find employees at a company
  • Schemas
    • Schemas
      • EnrichmentMeta
      • BatchResultsMeta
      • EmailValidationRequest
      • BatchEmailValidationRequest
      • EmailValidationResult
      • EmailValidationResponse
      • EmailValidationBatchResultsResponse
      • EmailFinderRequest
      • Lead
      • BatchEmailFinderRequest
      • EmailFinderResult
      • EmailFinderResponse
      • EmailFinderBatchResultsResponse
      • BatchSubmitData
      • BatchSubmitResponse
      • BatchStatusData
      • BatchStatusResponse
      • LookupRequest
      • StartEndDate
      • EducationHistoryItem
      • PositionHistoryItem
      • ReverseLookupResult
      • ReverseLookupResponse
      • BulkLookupResultsResponse
      • PhoneBatchRequest
      • PhoneLookupResult
      • PhoneLookupResponse
      • PhoneBulkJobSubmitData
      • PhoneBulkJobSubmitResponse
      • PhoneBulkJobStatusData
      • PhoneBulkJobStatusResponse
      • PhoneBulkResultItem
      • PhoneBulkJobResultsResponse
      • WalletBalance
      • WalletBalanceResponse
      • WalletTransaction
      • Pagination
      • WalletTransactionsResponse
      • TeamMember
      • Invitation
      • InviteBody
      • TeamMemberListResponse
      • InvitationResponse
      • InvitationListResponse
      • SuccessOperationResponse
      • WebhookEmailValidationResult
      • WebhookEmailFinderResult
      • WebhookPhoneResult
      • WebhookReverseLookupResult
      • WebhookEmailValidationCompletion
      • WebhookEmailFinderCompletion
      • WebhookPhoneCompletion
      • WebhookReverseLookupCompletion
      • CompanyFollowerRequest
      • StartCompanyFollowerResponse
      • StartCompanyFollowerData
      • CompanyFollowerProgressResponse
      • CompanyFollowerProgressData
      • CompanyFollowerResultsResponse
      • CompanyFollowerResultsData
      • FollowerProfile
      • CountEstimateRequest
      • StartCountEstimateResponse
      • StartCountEstimateData
      • CountEstimateStatusResponse
      • CountEstimateStatusData
      • CountEstimateResultData
      • FunctionBreakdownItem
      • SeniorityBreakdownItem
      • WebhookCompanyFollowerResult
      • WebhookCompanyFollowerCompletion
    • Response
      • BadRequest
      • Unauthorized
      • InsufficientCredits
      • NotFound
      • RateLimited
      • InternalError
    • ErrorEnvelope
    • BatchSubmitMeta
    • AsyncExportResponse
    • LeadExportJobProgress
    • LeadExportJobStatusResponse
    • LeadExportJobSummary
    • LeadExportJobListResponse
    • BulkLookupRequest
    • RevealJobSubmitResponse
    • BulkLookupSubmitData
    • RevealJobPollResponse
    • BulkLookupResponse
    • RevealJobSummary
    • RevealJobListResponse
    • LeadFinderSearchFilters
    • LeadSearchPreviewResult
    • LeadFinderPagination
    • LeadSearchRequest
    • LeadSearchResponse
    • LeadCountRequest
    • LeadCountResponse
    • LeadExportRequest
    • LeadRevealRequest
    • RevealedContact
    • LeadRevealResponse
    • LeadEnrichRequest
    • LeadEnrichResult
    • LeadEnrichResponse
    • UnlockNamesRequest
    • UnlockNamesResponse
    • SavedSearchItem
    • SavedSearchCreateRequest
    • SavedSearchListResponse
    • SavedSearchResponse
    • LeadFinderFilterOptionsResponse
    • LeadFinderSuggestResponse
    • LeadFinderDeletedResponse
    • AccessDeniedResponse
  1. Email Finder

Get batch finder results

GET
/email-finder/batch/{batchId}/results
Retrieve the results once the batch has finished. Results are paginated.
Credit settlement: On the first call after the batch reaches a terminal
status, we settle the final credit charge. Leads where no email was found
are not charged, and the difference is refunded.

Request

Authorization
API Key
Add parameter in header
x-api-key
Example:
x-api-key: ********************
or
Bearer Token
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
or
Path Params

Query Params

Responses

🟢200OK
application/json
Paginated finder results
Body

🟠401Unauthorized
🟠404Not Found
🟠429Too Many Requests
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://dev.enrich.so/api/v3/email-finder/batch/665a1f4e2c3b7800129dce01/results?page&limit' \
--header 'x-api-key: <api-key>'
Response Response Example
200 - Success
{
    "success": true,
    "data": {
        "batchId": "665b12cf3e4c9200138eaf10",
        "status": "completed",
        "totalItems": 3,
        "processedCount": 3,
        "results": [
            {
                "firstName": "Emily",
                "lastName": "Zhang",
                "domain": "figma.com",
                "found": true,
                "email": "emily.zhang@figma.com",
                "confidence": "high",
                "isCatchAll": false,
                "provider": "GOOGLE",
                "message": "Email found with high confidence"
            },
            {
                "firstName": "David",
                "lastName": "Kim",
                "domain": "vercel.com",
                "found": true,
                "email": "david.kim@vercel.com",
                "confidence": "medium",
                "isCatchAll": false,
                "provider": "GOOGLE",
                "message": "Email found with medium confidence"
            },
            {
                "firstName": "Aisha",
                "lastName": "Johnson",
                "domain": "cloudflare.com",
                "found": false,
                "message": "No professional email could be found for this person"
            }
        ]
    },
    "meta": {
        "requestId": "665b18a03e4c9200138eaf20",
        "creditsUsed": 20,
        "creditsRefunded": 10,
        "creditsRemaining": 24970,
        "totalItems": 3,
        "processedItems": 3
    }
}
Modified at 2026-02-07 15:01:45
Previous
Check batch finder progress
Next
Find phone numbers
Built with