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

    Rate Limits

    Rate limits are applied per organization (based on the API key's team). Limits scale with your credit pack.

    Per-plan limits#

    PlanBurst (req/sec)Sustained (req/min)
    Free560
    Growth25300
    Scale501,000
    Pro1005,000
    Enterprise20010,000
    Burst limits prevent short spikes from overwhelming the system. Sustained limits cap your average throughput over a rolling 60-second window.

    Endpoint-specific overrides#

    Some endpoint categories have tighter limits to protect resource-intensive services:

    Enrichment endpoints (POST:/api/enrich/*)#

    PlanSustained (req/min)
    Free10
    Growth100
    Scale500
    Pro2,000

    Bulk submit endpoints (POST:/api/bulk/*)#

    PlanBurst (req/sec)Sustained (req/min)
    Free12
    Growth310
    Scale520
    Pro1050
    Enterprise plans have no endpoint-specific overrides — global limits apply.

    Response headers#

    Every response includes rate limit headers:
    HeaderDescription
    X-RateLimit-LimitMaximum requests in the window
    X-RateLimit-RemainingRequests remaining in the window
    X-RateLimit-ResetSeconds until the window resets

    429 Too Many Requests#

    When you exceed a rate limit, the API returns a 429 response with a Retry-After header:
    {
      "statusCode": 429,
      "error": "Too Many Requests",
      "message": "Rate limit exceeded, please retry later",
      "retryAfter": 45
    }
    The Retry-After value (in seconds) tells you when you can safely retry.

    Tips for staying within limits#

    Use batch endpoints for large datasets instead of making many single requests. A single bulk submit counts as one request.
    Respect Retry-After — back off for the indicated duration before retrying.
    Implement exponential backoff for transient failures.
    Poll batch status at reasonable intervals (every 5–10 seconds) rather than in a tight loop.
    Monitor your usage via the X-RateLimit-Remaining header to adjust throughput before hitting limits.
    Upgrade your plan if you consistently hit limits — higher packs come with significantly higher rate limits.
    Modified at 2026-02-02 16:14:20
    Previous
    Credits & Pricing
    Next
    Authentication
    Built with