Person

Get a person

POST /v1/person

Requires people:enrich. Identify the person with exactly one of person_id, linkedin_url, or name plus company_domain.

{
    "identifier": { "person_id": "person_..." }
}

The request is strict. Removed depth and include fields return 422 rather than silently changing price or output.

Previously paid fresh profiles return 200. Unpaid, stale, or unseen profiles return a durable run immediately:

{
  "data": {
    "run_id": "...",
    "status": "queued",
    "poll_url": "/v1/person/runs/..."
  },
  "meta": { "usage": { "acu_used": 0, "billed": [], "free": [], "not_found": [] } }
}

Poll GET /v1/person/runs/{id} for the normal person response, or cancel an active run with DELETE /v1/person/runs/{id}. Run inputs and results are retrievable for seven days, then polling returns 410 run_expired.

What comes back

Every found record leads with:

• summary — a concise overview using sourced professional history, education, and verified interests.
• source_links — up to 25 deduplicated public evidence links, ordered by verification status and confidence.
• presence.platforms[] — verified LinkedIn, Instagram, TikTok, Facebook, X, and GitHub identities when found. A refreshed profile can include public bio, audience metrics, verification/private status, last activity, explicit topics, and up to six recent public posts or repositories with engagement and media evidence URLs.
• signals.interests[].source_url — the direct evidence URL for an interest, or null when no URL supports it.
• age_range — a conservative { min, max } range only when dated first-party or education evidence supports it; otherwise null.

The record also contains person_id, identity, all three deep sections, and provenance. Provenance is keyed by response field path and records source, source_url, first_seen, last_seen, and confidence; unknown fields do not receive invented provenance.

Usage

/v1/person has one mode: deep. The first successful profile costs 25 ACU ($2.50 face value) on every plan. The same organization can reread that person free for 90 days; stale evidence is refreshed inside that window without another charge.

Every response includes usage with acu_used, billed, free, and not_found. For successful responses it is meta.usage; for errors it is error.usage. Active-window rereads, validation errors, failures, and not-found results use 0 ACU.