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

Overview

Returns every source Huntd tracks for your organization, with counts. Not paginated: the list is small. The source values are the slugs you pass as ?source= to the other endpoints, and the ones that appear in sources arrays on people and companies. Pass a date window to scope the counts, for example ?discovered_days=30 for the last 30 UTC days.

Reading the Counts

  • people counts everyone we checked against the source. users counts the subset who are confirmed users. The gap between them is expected, not an error.
  • Company-level sources (level: "company") are verified per account, not per person, so people and users are null. Use userCompanies for those.
  • maintenance: true means the source is paused and its counts read 0 until it’s back.

Errors

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

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"

Response

Sources and counts

success
enum<boolean>
Available options:
true
organization
string

Your organization's domain.

Example:

"acme.com"

totals
object

Organization-wide totals for the requested date window.

sources
object[]