PAGES

← Hunter

Hunter — API

Hunter APIv2.0.0 Read the vendor's spec ↗

  • 182 endpoints
  • 16 versions archived since Sep 3, 2026
  • Last checked Nov 2, 2026

Find and verify professional email addresses and manage Hunter resources.

Get started

first call
$ curl "https://api.hunter.io/v2/tags?api_key=$API_KEY"

Set $API_KEY first, then paste.

Base URL
https://api.hunter.io/v2
Authenticate
API key as the api_key query parameter
2 other schemes
  • API key in the X-API-KEY header
  • Bearer token in the Authorization header

What it covers

10 more areas

Endpoints

182 of 182

Open an endpoint for a runnable command, its inputs and what it returns.

Lists 47

  • DELETE /company-lists/folders/{id} Delete a company list folder

    Loading…

  • DELETE /company-lists/{id} Delete a company list

    Loading…

  • DELETE /company-lists/{id}/companies/{company_id} Remove a company from a company list

    Loading…

  • DELETE /company-lists/{id}/favorite Unfavorite a company list

    Loading…

  • DELETE /leads-lists/folders/{id} Delete a lead list folder (hyphen alias)

    Loading…

  • DELETE /leads-lists/{id} Delete a lead list (hyphen alias)

    Loading…

  • DELETE /leads-lists/{id}/favorite Unfavorite a lead list (hyphen alias)

    Loading…

  • DELETE /leads_lists/folders/{id} Delete a lead list folder

    Loading…

  • DELETE /leads_lists/{id} Delete a lead list

    Loading…

  • DELETE /leads_lists/{id}/favorite Unfavorite a lead list

    Loading…

  • GET /company-lists List company lists

    Loading…

  • GET /company-lists/folders List company list folders

    Loading…

  • GET /company-lists/folders/{id} Get a company list folder

    Loading…

  • GET /company-lists/{id} Get a company list

    Loading…

  • GET /leads-lists List lead lists (hyphen alias)

    Loading…

  • GET /leads-lists/folders List lead list folders (hyphen alias)

    Loading…

  • GET /leads-lists/folders/{id} Get a lead list folder (hyphen alias)

    Loading…

  • GET /leads-lists/{id} Get a lead list (hyphen alias)

    Loading…

  • GET /leads_lists List lead lists

    Loading…

  • GET /leads_lists/folders List lead list folders

    Loading…

  • GET /leads_lists/folders/{id} Get a lead list folder

    Loading…

  • GET /leads_lists/{id} Get a lead list

    Loading…

  • GET /lookalikes Find lookalike companies from a company list or a domain

    Loading…

  • PATCH /company-lists/folders/{id} Update a company list folder

    Loading…

  • PATCH /company-lists/{id} Update a company list

    Loading…

  • PATCH /leads-lists/folders/{id} Update a lead list folder (hyphen alias)

    Loading…

  • PATCH /leads-lists/{id} Update a lead list (hyphen alias)

    Loading…

  • PATCH /leads_lists/folders/{id} Update a lead list folder

    Loading…

  • PATCH /leads_lists/{id} Update a lead list

    Loading…

  • POST /company-lists Create a company list

    Loading…

  • POST /company-lists/folders Create a company list folder

    Loading…

  • POST /company-lists/{id}/companies Add a company to a company list

    Loading…

  • POST /company-lists/{id}/favorite Favorite a company list

    Loading…

  • POST /leads-lists Create a lead list (hyphen alias)

    Loading…

  • POST /leads-lists/folders Create a lead list folder (hyphen alias)

    Loading…

  • POST /leads-lists/{id}/favorite Favorite a lead list (hyphen alias)

    Loading…

  • POST /leads-lists/{id}/merge Merge lead lists (hyphen alias)

    Loading…

  • POST /leads_lists Create a lead list

    Loading…

  • POST /leads_lists/folders Create a lead list folder

    Loading…

  • POST /leads_lists/{id}/favorite Favorite a lead list

    Loading…

  • POST /leads_lists/{id}/merge Merge lead lists

    Loading…

  • PUT /company-lists/folders/{id} Replace a company list folder

    Loading…

  • PUT /company-lists/{id} Replace a company list

    Loading…

  • PUT /leads-lists/folders/{id} Replace a lead list folder (hyphen alias)

    Loading…

  • PUT /leads-lists/{id} Replace a lead list (hyphen alias)

    Loading…

  • PUT /leads_lists/folders/{id} Replace a lead list folder

    Loading…

  • PUT /leads_lists/{id} Replace a lead list

    Loading…

Leads 22

  • DELETE /leads/{id} Delete a lead

    Loading…

  • DELETE /leads/{id}/tags/{tag_id} Remove a tag from a lead

    Loading…

  • DELETE /leads_custom_attributes/{id} Delete a lead custom attribute

    Loading…

  • GET /leads List leads

    Loading…

  • GET /leads/bulk/exist Check whether leads exist in bulk

    Loading…

  • GET /leads/exist Check whether a lead exists

    Loading…

  • GET /leads/{id} Get a lead

    Loading…

  • GET /leads_custom_attributes List lead custom attributes

    Loading…

  • GET /leads_custom_attributes/{id} Get a lead custom attribute

    Loading…

  • PATCH /leads/{id} Update a lead

    Loading…

  • PATCH /leads_custom_attributes/{id} Update a lead custom attribute

    Loading…

  • POST /leads Create a lead

    Loading…

  • POST /leads-imports Create a leads import from CSV data

    Loading…

  • POST /leads/bulk/delete Delete leads in bulk

    Loading…

  • POST /leads/bulk/move Move leads to another list in bulk

    Loading…

  • POST /leads/{id}/enrich Enrich a lead

    Loading…

  • POST /leads/{id}/tags Tag a lead

    Loading…

  • POST /leads_custom_attributes Create a lead custom attribute

    Loading…

  • PUT /leads Upsert a lead

    Loading…

  • PUT /leads/bulk Upsert leads in bulk

    Loading…

  • PUT /leads/{id} Replace a lead

    Loading…

  • PUT /leads_custom_attributes/{id} Replace a lead custom attribute

    Loading…

Sequences 21

  • DELETE /sequences/{id} Delete a sequence

    Loading…

  • DELETE /sequences/{id}/follow-ups/{follow_up_id} Delete a sequence follow-up step

    Loading…

  • DELETE /sequences/{id}/recipients Remove sequence recipients

    Loading…

  • DELETE /sequences/{sequence_id}/pause Resume a paused sequence

    Loading…

  • GET /sequences List sequences

    Loading…

  • GET /sequences/{id} Get a sequence

    Loading…

  • GET /sequences/{id}/follow-ups List sequence follow-up steps

    Loading…

  • GET /sequences/{id}/follow-ups/{follow_up_id} Get a sequence follow-up step

    Loading…

  • GET /sequences/{id}/recipients List sequence recipients

    Loading…

  • GET /sequences/{id}/stats Get sequence performance stats

    Loading…

  • PATCH /sequences/{id} Update a sequence

    Loading…

  • PATCH /sequences/{id}/follow-ups/{follow_up_id} Update a sequence follow-up step

    Loading…

  • POST /sequences Create a sequence

    Loading…

  • POST /sequences/{id}/follow-ups Add a sequence follow-up step

    Loading…

  • POST /sequences/{id}/recipients Add sequence recipients

    Loading…

  • POST /sequences/{id}/start Start a sequence

    Loading…

  • POST /sequences/{sequence_id}/archive Archive a sequence

    Loading…

  • POST /sequences/{sequence_id}/pause Pause a sequence

    Loading…

  • POST /sequences/{sequence_id}/test Send a test email for every step of a sequence

    Loading…

  • PUT /sequences/{id} Replace a sequence

    Loading…

  • PUT /sequences/{id}/follow-ups/{follow_up_id} Replace a sequence follow-up step

    Loading…

Tags 12

  • DELETE /company-tags/{id} Delete a company tag

    Loading…

  • DELETE /tags/{id} Delete a lead tag

    Loading…

  • GET /company-tags List company tags

    Loading…

  • GET /company-tags/{id} Get a company tag

    Loading…

  • GET /tags List lead tags

    Loading…

  • GET /tags/{id} Get a lead tag

    Loading…

  • PATCH /company-tags/{id} Update a company tag

    Loading…

  • PATCH /tags/{id} Update a lead tag

    Loading…

  • POST /company-tags Create a company tag

    Loading…

  • POST /tags Create a lead tag

    Loading…

  • PUT /company-tags/{id} Replace a company tag

    Loading…

  • PUT /tags/{id} Replace a lead tag

    Loading…

Finder 11

  • GET /domain-count Count domains matching discovery filters

    Loading…

  • GET /domain-finder Find the domain for a company

    Loading…

  • GET /domains-suggestion Suggest domains for a company name

    Loading…

  • GET /email-count Count email addresses for a domain

    Loading…

  • GET /email-finder Find a professional email address

    Loading…

  • GET /email-finder/found Get a previously found email address

    Loading…

  • POST /domain-finder Find the domain for a company via POST

    Loading…

  • POST /domain-search Find email addresses by domain using request-body parameters

    Loading…

  • POST /email-finder/found Get a previously found email address via POST

    Loading…

  • POST /multi-domain-search/reveal Reveal emails from a multi-domain search

    Loading…

Companies 10

  • DELETE /companies/{id} Delete a saved company

    Loading…

  • DELETE /companies/{id}/tags/{tag_id} Remove a tag from a saved company

    Loading…

  • GET /companies List saved companies

    Loading…

  • GET /companies/{id} Get a saved company

    Loading…

  • POST /companies Save a company

    Loading…

  • POST /companies/bulk/copy Copy companies to another list in bulk

    Loading…

  • POST /companies/bulk/delete Delete companies in bulk

    Loading…

  • POST /companies/bulk/move Move companies to another list in bulk

    Loading…

  • POST /companies/bulk/tag Tag companies in bulk

    Loading…

  • POST /companies/{id}/tags Tag a saved company

    Loading…

Email Accounts 9

  • GET /email-accounts List email accounts

    Loading…

  • GET /email-accounts/capacities Get email account sending capacities

    Loading…

  • GET /email-accounts/{id} Get an email account

    Loading…

  • GET /email-accounts/{id}/health-report Get an email account health report

    Loading…

  • GET /email-accounts/{id}/sequences List sequences using an email account

    Loading…

  • GET /email-accounts/{id}/usage Get an email account usage report

    Loading…

  • GET /email-accounts/{id}/warmup-report Get an email account warmup report

    Loading…

  • PATCH /email-accounts/{id} Update an email account

    Loading…

  • PUT /email-accounts/{id} Replace an email account

    Loading…

Campaigns 7

  • DELETE /campaigns/{id}/recipients Remove campaign recipients

    Loading…

  • GET /campaigns List campaigns

    Loading…

  • GET /campaigns/{id}/follow-ups/{follow_up_id} Get a campaign follow-up step

    Loading…

  • GET /campaigns/{id}/recipients List campaign recipients

    Loading…

  • POST /campaigns/{id}/follow-ups Add a campaign follow-up step

    Loading…

  • POST /campaigns/{id}/recipients Add campaign recipients

    Loading…

  • POST /campaigns/{id}/start Start a campaign

    Loading…

Webhooks 7

  • DELETE /webhooks Delete webhooks by identifier (legacy)

    Loading…

  • DELETE /webhooks/{id} Delete a webhook

    Loading…

  • GET /webhooks List webhooks

    Loading…

  • GET /webhooks/{id} Get a webhook

    Loading…

  • PATCH /webhooks/{id} Update a webhook

    Loading…

  • POST /webhooks Create a webhook

    Loading…

  • PUT /webhooks/{id} Replace a webhook

    Loading…

Templates 6

  • DELETE /message-templates/{id} Delete a message template

    Loading…

  • GET /message-templates List message templates

    Loading…

  • GET /message-templates/{id} Get a message template

    Loading…

  • PATCH /message-templates/{id} Update a message template

    Loading…

  • POST /message-templates Create a message template

    Loading…

  • PUT /message-templates/{id} Replace a message template

    Loading…

Api Keys 5

  • DELETE /api-keys/{id} Delete an API key

    Loading…

  • GET /api-keys List API keys

    Loading…

  • PATCH /api-keys/{id} Update an API key

    Loading…

  • POST /api-keys Create an API key

    Loading…

  • PUT /api-keys/{id} Replace an API key

    Loading…

Views 4

  • DELETE /discover/views/{id} Delete a saved discover view

    Loading…

  • GET /discover/views List saved discover views

    Loading…

  • GET /discover/views/{id} Get a saved discover view

    Loading…

  • POST /discover/views Create a saved discover view

    Loading…

Account 3

  • GET /account Get account details and usage

    Loading…

  • GET /account-stats Get account profile summary

    Loading…

  • PUT /account Update account details

    Loading…

Connected Apps 3

  • GET /connected-apps List connected apps

    Loading…

  • GET /connected-apps/{id} Get a connected app

    Loading…

  • POST /connected-apps/{id}/push Push data to a connected app

    Loading…

Discover 3

  • GET /discover/people Discover people matching filters

    Loading…

  • POST /discover Discover companies

    Loading…

  • POST /discover/people Discover people using request-body filters

    Loading…

Enrichment 3

  • GET /combined/find Enrich a person and company

    Loading…

  • GET /companies/find Enrich a company

    Loading…

  • GET /people/find Enrich a person

    Loading…

Messages 2

  • GET /messages List messages

    Loading…

  • POST /messages Send a one-off message

    Loading…

Usage 2

  • GET /usage Get credit usage summary

    Loading…

  • GET /usage/history Get credit usage history

    Loading…

Verifier 2

  • GET /email-insight Get deliverability insight for an email address

    Loading…

  • GET /email-verifier Verify an email address

    Loading…

Feedback 1

  • POST /feedback Submit product feedback

    Loading…

Team 1

  • GET /team/members List team members

    Loading…

Change log

    • +POST /sequences/{sequence_id}/test
    • +GET /lookalikes
    • +POST /leads-imports
    • +PUT /leads/bulk
    • −GET /domain-search/found
    • −POST /domain-search/found
    • −POST /leads/companies
    • −DELETE /admin/users/{id}/avatar
    • −GET /admin/users/{id}
    • +DELETE /admin/users/{id}/avatar
    • +DELETE /api-keys/{id}
    • +DELETE /campaigns/{id}/recipients
    • +DELETE /companies/{id}
    • +DELETE /companies/{id}/tags/{tag_id}
    • +DELETE /company-lists/folders/{id}
    • +DELETE /company-lists/{id}
    • +DELETE /company-lists/{id}/companies/{company_id}
    • +DELETE /company-lists/{id}/favorite
    • +DELETE /company-tags/{id}
    • +DELETE /discover/views/{id}
    • +DELETE /leads-lists/folders/{id}
    • +DELETE /leads-lists/{id}
    • +DELETE /leads-lists/{id}/favorite
    • +DELETE /leads/{id}
    • +DELETE /leads/{id}/tags/{tag_id}
    • +DELETE /leads_custom_attributes/{id}
    • +DELETE /leads_lists/folders/{id}
    • +DELETE /leads_lists/{id}
    • +DELETE /leads_lists/{id}/favorite
    • +DELETE /message-templates/{id}
    • +DELETE /sequences/{id}
    • +DELETE /sequences/{id}/follow-ups/{follow_up_id}
    • +DELETE /sequences/{id}/recipients
    • +DELETE /sequences/{sequence_id}/pause
    • +DELETE /tags/{id}
    • +DELETE /webhooks
    • +DELETE /webhooks/{id}
    • +GET /account-stats
    • +GET /admin/users/{id}
    • +GET /api-keys
    • +GET /campaigns
    • +GET /campaigns/{id}/follow-ups/{follow_up_id}
    • +GET /campaigns/{id}/recipients
    • +GET /companies
    • +GET /companies/{id}
    • +GET /company-lists
    • +GET /company-lists/folders
    • +GET /company-lists/folders/{id}
    • +GET /company-lists/{id}
    • +GET /company-tags
    • +GET /company-tags/{id}
    • +GET /connected-apps
    • +GET /connected-apps/{id}
    • +GET /discover/people
    • +GET /discover/views
    • +GET /discover/views/{id}
    • +GET /domain-count
    • +GET /domain-finder
    • +GET /domain-search/found
    • +GET /domains-suggestion
    • +GET /email-accounts
    • +GET /email-accounts/capacities
    • +GET /email-accounts/{id}
    • +GET /email-accounts/{id}/health-report
    • +GET /email-accounts/{id}/sequences
    • +GET /email-accounts/{id}/usage
    • +GET /email-accounts/{id}/warmup-report
    • +GET /email-finder/found
    • +GET /email-insight
    • +GET /leads
    • +GET /leads-lists
    • +GET /leads-lists/folders
    • +GET /leads-lists/folders/{id}
    • +GET /leads-lists/{id}
    • +GET /leads/bulk/exist
    • +GET /leads/exist
    • +GET /leads/{id}
    • +GET /leads_custom_attributes
    • +GET /leads_custom_attributes/{id}
    • +GET /leads_lists
    • +GET /leads_lists/folders
    • +GET /leads_lists/folders/{id}
    • +GET /leads_lists/{id}
    • +GET /message-templates
    • +GET /message-templates/{id}
    • +GET /messages
    • +GET /sequences
    • +GET /sequences/{id}
    • +GET /sequences/{id}/follow-ups
    • +GET /sequences/{id}/follow-ups/{follow_up_id}
    • +GET /sequences/{id}/recipients
    • +GET /sequences/{id}/stats
    • +GET /tags
    • +GET /tags/{id}
    • +GET /team/members
    • +GET /usage
    • +GET /usage/history
    • +GET /webhooks
    • +GET /webhooks/{id}
    • +PATCH /api-keys/{id}
    • +PATCH /company-lists/folders/{id}
    • +PATCH /company-lists/{id}
    • +PATCH /company-tags/{id}
    • +PATCH /email-accounts/{id}
    • +PATCH /leads-lists/folders/{id}
    • +PATCH /leads-lists/{id}
    • +PATCH /leads/{id}
    • +PATCH /leads_custom_attributes/{id}
    • +PATCH /leads_lists/folders/{id}
    • +PATCH /leads_lists/{id}
    • +PATCH /message-templates/{id}
    • +PATCH /sequences/{id}
    • +PATCH /sequences/{id}/follow-ups/{follow_up_id}
    • +PATCH /tags/{id}
    • +PATCH /webhooks/{id}
    • +POST /api-keys
    • +POST /campaigns/{id}/follow-ups
    • +POST /campaigns/{id}/recipients
    • +POST /campaigns/{id}/start
    • +POST /companies
    • +POST /companies/bulk/copy
    • +POST /companies/bulk/delete
    • +POST /companies/bulk/move
    • +POST /companies/bulk/tag
    • +POST /companies/{id}/tags
    • +POST /company-lists
    • +POST /company-lists/folders
    • +POST /company-lists/{id}/companies
    • +POST /company-lists/{id}/favorite
    • +POST /company-tags
    • +POST /connected-apps/{id}/push
    • +POST /discover/people
    • +POST /discover/views
    • +POST /domain-finder
    • +POST /domain-search/found
    • +POST /email-finder/found
    • +POST /feedback
    • +POST /leads
    • +POST /leads-lists
    • +POST /leads-lists/folders
    • +POST /leads-lists/{id}/favorite
    • +POST /leads-lists/{id}/merge
    • +POST /leads/bulk/delete
    • +POST /leads/bulk/move
    • +POST /leads/companies
    • +POST /leads/{id}/enrich
    • +POST /leads/{id}/tags
    • +POST /leads_custom_attributes
    • +POST /leads_lists
    • +POST /leads_lists/folders
    • +POST /leads_lists/{id}/favorite
    • +POST /leads_lists/{id}/merge
    • +POST /message-templates
    • +POST /messages
    • +POST /multi-domain-search
    • +POST /multi-domain-search/reveal
    • +POST /sequences
    • +POST /sequences/{id}/follow-ups
    • +POST /sequences/{id}/recipients
    • +POST /sequences/{id}/start
    • +POST /sequences/{sequence_id}/archive
    • +POST /sequences/{sequence_id}/pause
    • +POST /tags
    • +POST /webhooks
    • +PUT /account
    • +PUT /api-keys/{id}
    • +PUT /company-lists/folders/{id}
    • +PUT /company-lists/{id}
    • +PUT /company-tags/{id}
    • +PUT /email-accounts/{id}
    • +PUT /leads
    • +PUT /leads-lists/folders/{id}
    • +PUT /leads-lists/{id}
    • +PUT /leads/{id}
    • +PUT /leads_custom_attributes/{id}
    • +PUT /leads_lists/folders/{id}
    • +PUT /leads_lists/{id}
    • +PUT /message-templates/{id}
    • +PUT /sequences/{id}
    • +PUT /sequences/{id}/follow-ups/{follow_up_id}
    • +PUT /tags/{id}
    • +PUT /webhooks/{id}
browse all tools → score card for your toolchain →