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

Save a search

POST
/lead-finder/saved
Save a search filter combination for reuse. Free endpoint.
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
Body Params application/jsonRequired

Examples

Responses

🟢200OK
application/json
Search saved successfully
Headers

Body

🟠400Bad Request
🟠401Unauthorized
🟠403Too Many Requests
🟠429Internal Server Error
🔴500Forbidden
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://dev.enrich.so/api/v3/lead-finder/saved' \
--header 'x-api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "string",
    "filters": {
        "firstName": "string",
        "lastName": "string",
        "middleName": "string",
        "city": "string",
        "stateName": "string",
        "stateCode": "string",
        "countryName": "string",
        "countryCode": "string",
        "continent": "string",
        "countryRegion": "string",
        "linkedinUrl": "string",
        "linkedinHeadline": "string",
        "personHeadline": "string",
        "companyHeadline": "string",
        "linkedinIndustry": "string",
        "logoUrl": "string",
        "emailDomain": "string",
        "emailAddress": "string",
        "jobTitle": "string",
        "jobFunction": "string",
        "jobLevel": "string",
        "jobDescription": "string",
        "jobLocationCity": "string",
        "jobLocationState": "string",
        "jobLocationCountry": "string",
        "jobIsCurrent": true,
        "jobStartDate": "string",
        "jobCount": 0,
        "companyName": "string",
        "companyNameMode": "exact",
        "persona": "string",
        "languages": "string",
        "skills": "string",
        "certifications": "string",
        "patents": "string",
        "publications": "string",
        "websites": "string",
        "education": "string",
        "phone": "string",
        "cellphone": "string",
        "orgName": "string",
        "domain": "string",
        "aboutUs": "string",
        "companyEntityType": "string",
        "companyLegalType": "string",
        "employeeCount": 0,
        "employeeCountMax": 0,
        "employeeCountMin": 0,
        "foundedOn": 0,
        "headquartersCity": "string",
        "headquartersState": "string",
        "headquartersCountry": "string",
        "industrySicCode": "string",
        "industrySicDescription": "string",
        "industryNaicsCode": "string",
        "industryNaicsDescription": "string",
        "orgLinkedinUrl": "string",
        "locationCity": "string",
        "locationState": "string",
        "locationCountry": "string",
        "revenueMax": 0,
        "revenueMin": 0,
        "revenueBuckets": "string",
        "specialties": "string",
        "crmTechOrg": "string",
        "marketingAutomationTechOrg": "string",
        "abmTechOrg": "string",
        "salesAutomationTechOrg": "string",
        "analyticsTechOrg": "string",
        "cmsTechOrg": "string",
        "martechCategoriesOrg": "string",
        "conversationIntelligenceTechOrg": "string",
        "cloudProviderTechOrg": "string",
        "emailHostingTechOrg": "string",
        "emailSecurityTechOrg": "string",
        "applicationSecurityTechOrg": "string",
        "cloudSecurityTechOrg": "string",
        "developmentTechOrg": "string",
        "eCommercePlatformTechOrg": "string",
        "erpTechOrg": "string",
        "hasMobileAppOrg": true,
        "hasWebAppOrg": true,
        "hasCisoOrg": true,
        "hasCioOrg": true,
        "locationCountOrg": 0,
        "isLinkedinUrlClaimedOrg": true,
        "marketingRoleCountOrg": 0,
        "salesRoleCountOrg": 0,
        "operationsRoleCountOrg": 0,
        "businessDevelopmentRoleCountOrg": 0,
        "customerSuccessRoleCountOrg": 0,
        "itRoleCountOrg": 0,
        "grcRoleCountOrg": 0,
        "securityRoleCountOrg": 0,
        "devopsRoleCountOrg": 0,
        "networkInfrastructureRoleCountOrg": 0,
        "mobileDevRoleCountOrg": 0,
        "iosDevRoleCountOrg": 0,
        "androidDevRoleCountOrg": 0,
        "engineerRoleCountOrg": 0,
        "qaRoleCountOrg": 0,
        "marketingOpenRolesCountOrg": 0,
        "operationsOpenRolesCountOrg": 0,
        "salesOpenRolesCountOrg": 0,
        "accountExecutiveOpenRolesCountOrg": 0,
        "customerSuccessOpenRolesCountOrg": 0,
        "demandGenerationOpenRolesCountOrg": 0,
        "businessDevelopmentOpenRolesCountOrg": 0,
        "itOpenRolesCountOrg": 0,
        "securityOpenRolesCountOrg": 0,
        "grcOpenRolesCountOrg": 0,
        "devopsOpenRolesCountOrg": 0,
        "networkInfrastructureOpenRolesCountOrg": 0,
        "monthlyOrganicTrafficOrg": 0,
        "monthlyPaidTrafficOrg": 0,
        "totalMonthlyTrafficOrg": 0,
        "monthlyGoogleAdspendOrg": 0,
        "employeeOnLinkedinGrowthRateOrg": 0,
        "isWebsiteForSaleOrg": true,
        "topAppleappstoreUrlOrg": "string",
        "topAppstoreRatingOrg": 0,
        "topAppstoreReviewCountOrg": 0,
        "lastAppstoreUpdateOrg": "string",
        "appstoreUpdateCountOrg": 0,
        "appstoreAppCategoryOrg": "string",
        "topPlaystoreUrlOrg": "string",
        "topPlaystoreRatingOrg": 0,
        "topPlaystoreReviewCountOrg": 0,
        "lastPlaystoreUpdateOrg": "string",
        "playstoreDownloadCountOrg": 0,
        "playstoreAppCategoryOrg": "string",
        "totalReviewsOrg": 0,
        "lastFundingDateOrg": "string",
        "lastFundingAmountOrg": 0,
        "leadInvestorsOrg": "string",
        "lastFundingTypeOrg": "string",
        "fundingRoundNumberOfInvestorsOrg": 0,
        "totalFundingAmountOrg": 0
    }
}'
Response Response Example
200 - Success
{
    "success": true,
    "data": {
        "id": "665e0b2f4a6d8c001abc1234",
        "name": "Engineering VPs in Bay Area",
        "filters": {
            "jobFunction": [
                "Engineering"
            ],
            "jobLevel": [
                "VP"
            ]
        },
        "createdAt": "2025-06-03T14:00:00.000Z",
        "updatedAt": "2025-06-03T14:00:00.000Z"
    },
    "meta": {
        "requestId": "req_664f2b3c9a1e4d0012abcdf6"
    }
}
Modified at 2026-03-19 14:24:59
Previous
List saved searches
Next
Delete a saved search
Built with