1. Email Validation
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 Validation

Get batch validation results

GET
/email-validation/batch/{batchId}/results
Fetch the results once your batch has finished. Results are paginated — use
page and limit to walk through them.
Credit settlement: The first time you call this after the batch reaches
completed or failed, we calculate the final cost and refund any excess
credits. Subsequent calls return the cached settlement.

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 validation 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-validation/batch/665a1f4e2c3b7800129dce01/results?page&limit' \
--header 'x-api-key: <api-key>'
Response Response Example
200 - Success
{
    "success": true,
    "data": {
        "batchId": "665a1f4e2c3b7800129dce01",
        "status": "completed",
        "totalItems": 4,
        "processedCount": 4,
        "results": [
            {
                "email": "sarah.chen@stripe.com",
                "result": "valid",
                "message": "The mailbox exists and is accepting mail",
                "isCatchAll": false,
                "provider": "GOOGLE",
                "confidence": "high"
            },
            {
                "email": "james.rodriguez@hubspot.com",
                "result": "valid",
                "message": "The mailbox exists and is accepting mail",
                "isCatchAll": false,
                "provider": "MICROSOFT",
                "confidence": "definitive"
            },
            {
                "email": "priya.patel@notion.so",
                "result": "invalid",
                "message": "The mailbox does not exist on this server",
                "isCatchAll": false,
                "provider": "GOOGLE",
                "confidence": "definitive"
            },
            {
                "email": "marco.silva@datadog.com",
                "result": "risky",
                "message": "The domain accepts all addresses (catch-all) so delivery cannot be guaranteed",
                "isCatchAll": true,
                "provider": "SMTP",
                "confidence": "low"
            }
        ]
    },
    "meta": {
        "requestId": "665a23bc2c3b7800129dce10",
        "creditsUsed": 2,
        "creditsRefunded": 2,
        "creditsRemaining": 24997,
        "totalItems": 4,
        "processedItems": 4
    }
}
Modified at 2026-02-07 15:01:45
Previous
Check batch validation progress
Next
Find a professional email
Built with