List People

GET

api

public

people

curl -X GET "https://app.gethuntd.com/api/v1/public/people?is_user=true&limit=100" \
  -H "X-API-Key: hntd_abc12345_yoursecretkey"

const params = new URLSearchParams({ is_user: 'true', limit: '100' });

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

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

import requests
import os

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

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

{
  "success": true,
  "pagination": { "page": 1, "limit": 100, "total": 842, "totalPages": 9 },
  "data": [
    {
      "id": "62381c7cc5fc496eff56fd60",
      "firstName": "Ada",
      "lastName": "Lovelace",
      "email": "ada@acme.com",
      "jobTitle": "VP Engineering",
      "seniority": "VP",
      "department": "Engineering",
      "jobFunction": "Engineering",
      "company": "Acme",
      "companyDomain": "acme.com",
      "companySize": 420,
      "industry": "software,information technology & services",
      "location": "San Francisco",
      "country": "United States",
      "linkedinUrl": "https://linkedin.com/in/example",
      "sources": ["devin"],
      "discoveredAt": "2026-07-31T17:28:28.725Z"
    }
  ]
}

{
  "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/people?is_user=true&limit=100" \
  -H "X-API-Key: hntd_abc12345_yoursecretkey"

const params = new URLSearchParams({ is_user: 'true', limit: '100' });

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

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

import requests
import os

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

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

{
  "success": true,
  "pagination": { "page": 1, "limit": 100, "total": 842, "totalPages": 9 },
  "data": [
    {
      "id": "62381c7cc5fc496eff56fd60",
      "firstName": "Ada",
      "lastName": "Lovelace",
      "email": "ada@acme.com",
      "jobTitle": "VP Engineering",
      "seniority": "VP",
      "department": "Engineering",
      "jobFunction": "Engineering",
      "company": "Acme",
      "companyDomain": "acme.com",
      "companySize": 420,
      "industry": "software,information technology & services",
      "location": "San Francisco",
      "country": "United States",
      "linkedinUrl": "https://linkedin.com/in/example",
      "sources": ["devin"],
      "discoveredAt": "2026-07-31T17:28:28.725Z"
    }
  ]
}

{
  "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 people Huntd tracks for your organization, newest first. Supports pagination, date filtering and source / is_user filtering.

An empty sources array means we checked this person and found no user account, not that they are untracked. Add is_user=true if you only want confirmed users.

Incremental Sync

discoveredAt always agrees with the date filter, so a daily job can pull only what changed. Overlap the window by a day and upsert on id, which is stable across pages and runs.

// Run daily. discovered_days=2 overlaps by one day so nothing is missed at the boundary.
const params = new URLSearchParams({ discovered_days: '2', is_user: 'true', limit: '1000' });

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

for (const person of body.data) {
  await db.people.upsert({ where: { id: person.id }, data: person });
}

import os
import requests

# Run daily. discovered_days=2 overlaps by one day so nothing is missed at the boundary.
body = requests.get(
    'https://app.gethuntd.com/api/v1/public/people',
    params={'discovered_days': 2, 'is_user': 'true', 'limit': 1000},
    headers={'X-API-Key': os.environ['HUNTD_API_KEY']}
).json()

for person in body['data']:
    db.upsert_person(person['id'], person)

For a first full backfill, use Stream People instead of paging.

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 people

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/people?is_user=true&limit=100" \
  -H "X-API-Key: hntd_abc12345_yoursecretkey"

const params = new URLSearchParams({ is_user: 'true', limit: '100' });

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

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

import requests
import os

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

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

{
  "success": true,
  "pagination": { "page": 1, "limit": 100, "total": 842, "totalPages": 9 },
  "data": [
    {
      "id": "62381c7cc5fc496eff56fd60",
      "firstName": "Ada",
      "lastName": "Lovelace",
      "email": "ada@acme.com",
      "jobTitle": "VP Engineering",
      "seniority": "VP",
      "department": "Engineering",
      "jobFunction": "Engineering",
      "company": "Acme",
      "companyDomain": "acme.com",
      "companySize": 420,
      "industry": "software,information technology & services",
      "location": "San Francisco",
      "country": "United States",
      "linkedinUrl": "https://linkedin.com/in/example",
      "sources": ["devin"],
      "discoveredAt": "2026-07-31T17:28:28.725Z"
    }
  ]
}

{
  "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

Overview

Incremental Sync

Errors

Authorizations

Query Parameters

Response

​Overview

​Incremental Sync

​Errors

Authorizations

Query Parameters

Response

Overview

Incremental Sync

Errors