# Hunter Lists API

**Canonical:** https://apis.io/apis/hunter/hunter-lists-api/  
**Provider:** Hunter — https://apis.io/providers/hunter/  
**Base URL:** https://api.hunter.io/v2  
**Documentation:** https://hunter.io/api-documentation/v2#account

Hunter Lists API is one of 22 APIs that [Hunter](https://apis.io/providers/hunter/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 1 JSON Schema definition. Tagged areas include List. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 1 JSON Schema.

The Lists API from Hunter — 20 operation(s) for lists.

## Operations (47)

| Method | Path | Summary |
|---|---|---|
| GET | `/leads_lists` | List lead lists |
| POST | `/leads_lists` | Create a lead list |
| GET | `/leads_lists/{id}` | Get a lead list |
| PATCH | `/leads_lists/{id}` | Update a lead list |
| PUT | `/leads_lists/{id}` | Replace a lead list |
| DELETE | `/leads_lists/{id}` | Delete a lead list |
| GET | `/leads_lists/folders` | List lead list folders |
| POST | `/leads_lists/folders` | Create a lead list folder |
| GET | `/leads_lists/folders/{id}` | Get a lead list folder |
| PATCH | `/leads_lists/folders/{id}` | Update a lead list folder |
| PUT | `/leads_lists/folders/{id}` | Replace a lead list folder |
| DELETE | `/leads_lists/folders/{id}` | Delete a lead list folder |
| POST | `/leads_lists/{id}/favorite` | Favorite a lead list |
| DELETE | `/leads_lists/{id}/favorite` | Unfavorite a lead list |
| POST | `/leads_lists/{id}/merge` | Merge lead lists |
| GET | `/leads-lists` | List lead lists (hyphen alias) |
| POST | `/leads-lists` | Create a lead list (hyphen alias) |
| GET | `/leads-lists/{id}` | Get a lead list (hyphen alias) |
| PATCH | `/leads-lists/{id}` | Update a lead list (hyphen alias) |
| PUT | `/leads-lists/{id}` | Replace a lead list (hyphen alias) |
| DELETE | `/leads-lists/{id}` | Delete a lead list (hyphen alias) |
| GET | `/leads-lists/folders` | List lead list folders (hyphen alias) |
| POST | `/leads-lists/folders` | Create a lead list folder (hyphen alias) |
| GET | `/leads-lists/folders/{id}` | Get a lead list folder (hyphen alias) |
| PATCH | `/leads-lists/folders/{id}` | Update a lead list folder (hyphen alias) |
| PUT | `/leads-lists/folders/{id}` | Replace a lead list folder (hyphen alias) |
| DELETE | `/leads-lists/folders/{id}` | Delete a lead list folder (hyphen alias) |
| POST | `/leads-lists/{id}/favorite` | Favorite a lead list (hyphen alias) |
| DELETE | `/leads-lists/{id}/favorite` | Unfavorite a lead list (hyphen alias) |
| POST | `/leads-lists/{id}/merge` | Merge lead lists (hyphen alias) |
| GET | `/company-lists` | List company lists |
| POST | `/company-lists` | Create a company list |
| GET | `/company-lists/{id}` | Get a company list |
| PATCH | `/company-lists/{id}` | Update a company list |
| PUT | `/company-lists/{id}` | Replace a company list |
| DELETE | `/company-lists/{id}` | Delete a company list |
| GET | `/company-lists/folders` | List company list folders |
| POST | `/company-lists/folders` | Create a company list folder |
| GET | `/company-lists/folders/{id}` | Get a company list folder |
| PATCH | `/company-lists/folders/{id}` | Update a company list folder |
| PUT | `/company-lists/folders/{id}` | Replace a company list folder |
| DELETE | `/company-lists/folders/{id}` | Delete a company list folder |
| POST | `/company-lists/{id}/favorite` | Favorite a company list |
| DELETE | `/company-lists/{id}/favorite` | Unfavorite a company list |
| POST | `/company-lists/{id}/companies` | Add a company to a company list |
| DELETE | `/company-lists/{id}/companies/{company_id}` | Remove a company from a company list |
| GET | `/lookalikes` | Find lookalike companies from a company list or a domain |

## Machine-readable artifacts (16)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/hunter/refs/heads/main/openapi/hunter-lists-api-openapi.yml
- **Documentation** — https://hunter.io/api-documentation/v2#domain-search
- **Documentation** — https://hunter.io/api-documentation/v2#email-finder
- **Documentation** — https://hunter.io/api-documentation/v2#email-verifier
- **Documentation** — https://hunter.io/api-documentation/v2#email-count
- **Documentation** — https://hunter.io/api-documentation/v2#account
- **Documentation** — https://hunter.io/api-documentation/v2#discover
- **Documentation** — https://hunter.io/api-documentation/v2#email-enrichment
- **Documentation** — https://hunter.io/api-documentation/v2#company-enrichment
- **Documentation** — https://hunter.io/api-documentation/v2#combined-enrichment
- **Documentation** — https://hunter.io/api-documentation/v2#leads
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/hunter/refs/heads/main/json-schema/hunter-lead-schema.json
- **JSONLD** — https://raw.githubusercontent.com/api-evangelist/hunter/refs/heads/main/json-ld/hunter-context.jsonld
- **Documentation** — https://hunter.io/api-documentation/v2#leads_lists
- **Documentation** — https://hunter.io/api-documentation/v2#campaigns
- **Documentation** — https://hunter.io/api-documentation/v2#logo

## Other Hunter APIs (12)

- [Hunter Account API](https://apis.io/apis/hunter/hunter-account-api/)
- [Hunter Campaigns API](https://apis.io/apis/hunter/hunter-campaigns-api/)
- [Hunter Discover API](https://apis.io/apis/hunter/hunter-discover-api/)
- [Hunter Leads API](https://apis.io/apis/hunter/hunter-leads-api/)
- [Hunter API Keys API](https://apis.io/apis/hunter/hunter-api-keys-api/)
- [Hunter Companies API](https://apis.io/apis/hunter/hunter-companies-api/)
- [Hunter Connected Apps API](https://apis.io/apis/hunter/hunter-connected-apps-api/)
- [Hunter Email Accounts API](https://apis.io/apis/hunter/hunter-email-accounts-api/)
- [Hunter Enrichment API](https://apis.io/apis/hunter/hunter-enrichment-api/)
- [Hunter Feedback API](https://apis.io/apis/hunter/hunter-feedback-api/)
- [Hunter Finder API](https://apis.io/apis/hunter/hunter-finder-api/)
- [Hunter Messages API](https://apis.io/apis/hunter/hunter-messages-api/)

## Tags

List

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/hunter/hunter-lists-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/hunter/.