1. Lead 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
    • Validate emails in batch
    • Check batch validation progress
    • Get batch validation results
  • Email Finder
    • Find a professional email
    • Find emails in batch
    • Check batch finder progress
    • Get batch finder results
  • Phone Finder
    • Find phone numbers
    • Find phone numbers in batch
    • Check bulk phone lookup progress
    • Get bulk phone lookup results
  • Reverse Email Lookup
    • Look up professional profiles in batch
    • Look up a professional profile by email
    • Check bulk lookup progress
    • Get bulk lookup results
  • 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
      POST
    • Export leads to CSV (async)
      POST
    • Count matching leads
      POST
    • Reveal contact info
      POST
    • Enrich contacts with specific fields
      POST
    • Unlock full last names
      POST
    • List saved searches
      GET
    • Save a search
      POST
    • Delete a saved search
      DELETE
    • Get filter options
      GET
    • Suggest company names
      GET
    • Poll reveal/enrich job
      GET
    • List reveal/enrich jobs
      GET
    • List export jobs
      GET
    • Poll export job status
      GET
    • Download export CSV
      GET
  • 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. Lead Finder

Poll reveal/enrich job

GET
/lead-finder/reveal-jobs/{jobId}
Poll the status of a reveal or enrich job. Call repeatedly until status is "completed" or "failed". Polling is always free.
Recommended interval: 2 seconds.
Requires approved Lead Finder access. Returns 403 if your team has not been approved.

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

Responses

🟢200
application/json
Job status returned
Headers

Body

🟠400
🟠401
🟠403
🟠404
🟠429
🔴500
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://dev.enrich.so/api/v3/lead-finder/reveal-jobs/rj_a1b2c3d4e5f6g7h8' \
--header 'x-api-key: <api-key>'
Response Response Example
200 - Job is pending
{
    "success": true,
    "data": {
        "jobId": "rj_a1b2c3d4e5f6g7h8",
        "status": "pending",
        "jobType": "reveal",
        "fields": [
            "email",
            "phone"
        ],
        "progress": {
            "processed": 0,
            "total": 5
        },
        "createdAt": "2026-03-02T10:00:00.000Z"
    }
}
Modified at 2026-03-19 14:24:59
Previous
Suggest company names
Next
List reveal/enrich jobs
Built with