People

Get an evidence-backed person record

Resolve one reviewed deep person profile. An eligible cached profile returns 200, including stale data with a queued refresh. Unseen people and snapshots requiring new review return a durable 202 run. Fresh research can take minutes; poll the returned run ID. A completed uncertain identity returns data:null with meta.resolution=unsure and reason ambiguous_identity or insufficient_evidence. The first successful profile costs exactly 25 ACU on every plan; organization-wide rereads are free for 90 days. Failed, uncertain, and not-found runs are free. Current role fields, age, and social audience/activity metrics are not populated by the current reviewed projection.

post/v1/person

Request

  • Base URL: https://api.ploid.com
  • URL: https://api.ploid.com/v1/person
  • Auth: one of:
    • HTTP bearer
    • API key in header x-api-key

Headers

Idempotency-Keystring

Recommended on POST. Reusing the same key replays the same run and bills once.

Request body

Response

Cached reviewed person record (possibly stale with refresh queued) or a free not-found result.

OR

Changes

No recorded changes to this operation across all 1 revision of this API.