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

    Credits & Pricing

    Enrich uses a credit-based system. Every API call consumes credits based on the endpoint. You purchase credits through monthly packs.

    Credit packs#

    PackCreditsPriceCost per credit
    Growth100,000$49/mo$0.00049
    Scale500,000$149/mo$0.000298
    Pro2,500,000$499/mo$0.0002
    New accounts receive 100 free credits to get started.

    Per-endpoint credit costs#

    Credit costs per endpoint:
    EndpointCreditsDescription
    Email Validation1Validate a single email
    Email Finder10Find email from name + domain
    Reverse Email Lookup10Get professional profile from email
    Phone Finder500Get phone numbers from email/profile
    Batch operations use the same per-item cost as single lookups.

    How bulk credits work#

    Bulk endpoints use a reserve-and-settle model:
    1.
    Submit — You submit a batch of items. The full estimated cost (itemCount * creditCostPerItem) is reserved from your balance immediately.
    2.
    Process — Items are processed asynchronously. Polling for status is free.
    3.
    Settle — When you fetch results and the batch has reached a terminal status (completed, failed), credits are settled. You're only charged for successfully processed items. Excess reserved credits are refunded.
    Settlement is idempotent — fetching results multiple times won't charge you again.

    Example#

    You submit a bulk phone lookup with 100 emails:
    Reserve: 100 * 500 = 50,000 credits deducted
    Processing: 90 items found phones, 10 returned no results
    Settle: Charged for 90 items (45,000 credits). 5,000 credits refunded.

    Single lookup refunds#

    For single (non-batch) lookups, if no results are found, credits are automatically refunded. The response will show creditsUsed: 0.

    Insufficient credits#

    If your balance is too low for a request, you'll receive a 402 response:
    {
      "type": "https://dev.enrich.so/errors/insufficient-credits",
      "title": "Insufficient Credits",
      "status": 402,
      "detail": "This operation requires 100 credits, but your balance is 50 credits.",
      "currentBalance": 50,
      "required": 100,
      "shortfall": 50
    }

    Checking your balance#

    Use the wallet endpoint to check your current balance at any time:
    Every successful API response also includes creditsUsed and creditsRemaining in the meta object.
    Modified at 2026-02-02 16:14:21
    Previous
    API Reference
    Next
    Rate Limits
    Built with