List Companies

GET

api

public

companies

curl -X GET "https://app.gethuntd.com/api/v1/public/companies?limit=50" \
  -H "X-API-Key: hntd_abc12345_yoursecretkey"

const params = new URLSearchParams({ limit: '50' });

const response = await fetch(
  `https://app.gethuntd.com/api/v1/public/companies?${params}`,
  { headers: { 'X-API-Key': process.env.HUNTD_API_KEY } }
);

const { data, pagination } = await response.json();
console.log(`${data.length} of ${pagination.total} companies`);

import requests
import os

response = requests.get(
    'https://app.gethuntd.com/api/v1/public/companies',
    params={'limit': 50},
    headers={'X-API-Key': os.environ['HUNTD_API_KEY']}
)

body = response.json()
print(f"{len(body['data'])} of {body['pagination']['total']} companies")

{
  "success": true,
  "pagination": { "page": 1, "limit": 50, "total": 3866, "totalPages": 78 },
  "data": [
    {
      "domain": "acme.com",
      "name": "Acme",
      "size": 2100,
      "industry": "banking,financial services",
      "country": "United States",
      "people": 12,
      "sources": ["devin", "factory"],
      "discoveredAt": "2026-07-31T18:31:58.294Z"
    }
  ]
}

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "`limit` may not exceed 1000."
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "API key is missing, invalid, or has been revoked."
  }
}

{
  "success": false,
  "error": {
    "code": "SOURCE_NOT_ALLOWED",
    "message": "Your organization does not have access to source `gong`."
  }
}

Availability: Enterprise plan, on https://app.gethuntd.com. Agency keys receive 403 ENDPOINT_NOT_ON_PLAN. Uses no credits.

curl -X GET "https://app.gethuntd.com/api/v1/public/companies?limit=50" \
  -H "X-API-Key: hntd_abc12345_yoursecretkey"

const params = new URLSearchParams({ limit: '50' });

const response = await fetch(
  `https://app.gethuntd.com/api/v1/public/companies?${params}`,
  { headers: { 'X-API-Key': process.env.HUNTD_API_KEY } }
);

const { data, pagination } = await response.json();
console.log(`${data.length} of ${pagination.total} companies`);

import requests
import os

response = requests.get(
    'https://app.gethuntd.com/api/v1/public/companies',
    params={'limit': 50},
    headers={'X-API-Key': os.environ['HUNTD_API_KEY']}
)

body = response.json()
print(f"{len(body['data'])} of {body['pagination']['total']} companies")

{
  "success": true,
  "pagination": { "page": 1, "limit": 50, "total": 3866, "totalPages": 78 },
  "data": [
    {
      "domain": "acme.com",
      "name": "Acme",
      "size": 2100,
      "industry": "banking,financial services",
      "country": "United States",
      "people": 12,
      "sources": ["devin", "factory"],
      "discoveredAt": "2026-07-31T18:31:58.294Z"
    }
  ]
}

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "`limit` may not exceed 1000."
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "API key is missing, invalid, or has been revoked."
  }
}

{
  "success": false,
  "error": {
    "code": "SOURCE_NOT_ALLOWED",
    "message": "Your organization does not have access to source `gong`."
  }
}

Overview

Returns the companies (accounts) Huntd tracks for your organization, newest first. Supports pagination, date filtering and source / is_user filtering.

An empty sources array means we checked and found no user, not that the company is untracked.

Joining to People

companyDomain on List People is normalized to exactly match domain here, so the two endpoints join directly with no cleanup.

const key = { 'X-API-Key': process.env.HUNTD_API_KEY };
const base = 'https://app.gethuntd.com/api/v1/public';

const companies = await (await fetch(`${base}/companies?limit=1000`, { headers: key })).json();
const people = await (await fetch(`${base}/people?limit=1000&is_user=true`, { headers: key })).json();

// Group people under their company by domain
const byDomain = new Map(companies.data.map((c) => [c.domain, { ...c, people: [] }]));
for (const person of people.data) {
  byDomain.get(person.companyDomain)?.people.push(person);
}

import os
import requests

key = {'X-API-Key': os.environ['HUNTD_API_KEY']}
base = 'https://app.gethuntd.com/api/v1/public'

companies = requests.get(f'{base}/companies', params={'limit': 1000}, headers=key).json()
people = requests.get(f'{base}/people', params={'limit': 1000, 'is_user': 'true'}, headers=key).json()

# Group people under their company by domain
by_domain = {c['domain']: {**c, 'people': []} for c in companies['data']}
for person in people['data']:
    company = by_domain.get(person['companyDomain'])
    if company:
        company['people'].append(person)

The people integer on this endpoint is the count Huntd tracks. It won’t always equal the number of rows List People returns for that domain, because your people query may be filtered by source, date or is_user.

For a full export, use Stream Companies.

Errors

HTTP	Error Code	Description
400	`INVALID_PARAMETER`	A query parameter is malformed or out of range
401	`INVALID_API_KEY`	API key is missing, invalid, or has been revoked
403	`ENDPOINT_NOT_ON_PLAN`	Your plan doesn’t include this endpoint (Agency keys)
403	`SUBSCRIPTION_INACTIVE`	Your workspace has no active subscription. Contact your account manager.
403	`SOURCE_NOT_ALLOWED`	Your organization doesn’t have access to the requested `source`
423	`SOURCE_UNAVAILABLE`	The requested `source` is paused for maintenance. Retry later.
429	`RATE_LIMIT_EXCEEDED`	Over 60 requests per minute. Wait `Retry-After` seconds.
500	`INTERNAL_ERROR`	Something broke on our side. Safe to retry.
503	`ORG_KIND_UNAVAILABLE`	Your plan briefly couldn’t be confirmed. Retry.

Authorizations

X-API-Key

string

header

required

API key in format: hntd_{id}_{secret}. Create one in Settings → API & webhooks. Authorization: Bearer is also accepted.

Query Parameters

page

integer

default:1

1-indexed page number.

Required range: x >= 1

limit

integer

default:100

Results per page. Maximum 1000: a higher value returns 400 INVALID_PARAMETER rather than being clamped.

Required range: 1 <= x <= 1000

skip_count

enum<string>

Skip the count query. total and totalPages come back null, which is faster on large result sets.

Available options:

1,

true

discovered_days

integer

The last N UTC days, including today (2 = today and yesterday). "Discovered" means when we last checked the row, not when it was confirmed. Can't be combined with discovered_from / discovered_to.

Required range: 1 <= x <= 366

discovered_from

string<date>

Inclusive UTC start day, YYYY-MM-DD.

Example:

"2026-07-01"

discovered_to

string<date>

Inclusive UTC end day, YYYY-MM-DD.

Example:

"2026-07-31"

source

string

Restrict to one source slug, as returned by List Sources.

Example:

"gong"

is_user

enum<string>

default:all

true: confirmed users only. false: checked but not a user. all: both.

Available options:

all,

true,

false

Response

A page of companies

success

enum<boolean>

Available options:

true

pagination

object

Show child attributes

data

object[]

Show child attributes

curl -X GET "https://app.gethuntd.com/api/v1/public/companies?limit=50" \
  -H "X-API-Key: hntd_abc12345_yoursecretkey"

const params = new URLSearchParams({ limit: '50' });

const response = await fetch(
  `https://app.gethuntd.com/api/v1/public/companies?${params}`,
  { headers: { 'X-API-Key': process.env.HUNTD_API_KEY } }
);

const { data, pagination } = await response.json();
console.log(`${data.length} of ${pagination.total} companies`);

import requests
import os

response = requests.get(
    'https://app.gethuntd.com/api/v1/public/companies',
    params={'limit': 50},
    headers={'X-API-Key': os.environ['HUNTD_API_KEY']}
)

body = response.json()
print(f"{len(body['data'])} of {body['pagination']['total']} companies")

{
  "success": true,
  "pagination": { "page": 1, "limit": 50, "total": 3866, "totalPages": 78 },
  "data": [
    {
      "domain": "acme.com",
      "name": "Acme",
      "size": 2100,
      "industry": "banking,financial services",
      "country": "United States",
      "people": 12,
      "sources": ["devin", "factory"],
      "discoveredAt": "2026-07-31T18:31:58.294Z"
    }
  ]
}

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMETER",
    "message": "`limit` may not exceed 1000."
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "API key is missing, invalid, or has been revoked."
  }
}

{
  "success": false,
  "error": {
    "code": "SOURCE_NOT_ALLOWED",
    "message": "Your organization does not have access to source `gong`."
  }
}

Huntd Enterprise API

Email Check

List Companies

Overview

Joining to People

Errors

Authorizations

Query Parameters

Response

​Overview

​Joining to People

​Errors

Authorizations

Query Parameters

Response

Overview

Joining to People

Errors