Sign up for free
View as Markdown

Get Person

GET/v2/people/{id}

Read one person by GetProspect id: the People Enrich profile, with your workspace's saved block and edits and any email or phone your workspace already owns. Costs no credits: it never reveals or charges anything - to reveal an email or a phone, call People Enrich. Uses 1 unit of the enrich rate limit, none when your workspace already owns the person. Returns 404 when the id names no person we can serve.

Path parameters

  • idstringrequired

    The GetProspect person id (24 hex characters).

    Example: "64f1a2b3c4d5e6f7a8b9c0d1"

Responses

  • 200 The person.
  • 400 The id is not a person id (VALIDATION_ERROR, payload.code: invalid_format).
  • 401 Missing, unknown or inactive credentials (UNAUTHORIZED).
  • 404 No person we can serve has this id (NOT_FOUND).
  • 429 Over the enrich rate limit (RATE_LIMIT); wait Retry-After seconds. Sent only where rate limits are enforced.
  • 500 Unexpected server error.

For error handling see Errors. Response objects are described in Person object and Company object.