Skip to main content
GET
Get a person
Returns one person by id: name, display name, primary email, type, status, and every human seat with its position, team, department, monthly budget and spend. A merged-away id returns the person it was merged into, with redirectedFrom. It never returns the avatar URL. Requires workforce:read at the platform scope; a key or app whose grant covers only some org units receives 403. A person with any seat in a customer organization or an org unit under one returns 404, exactly as an unknown person, and so does an ID merged into such a person.

Authorizations

Authorization
string
header
required

An External App: the JWT it obtains from POST /oauth/token with OAuth2 client_credentials. Pass as Authorization: Bearer <jwt>. An app's static companion key also authenticates as the app, but is deprecated and is not protected by Idempotency-Key.

Path Parameters

personId
string
required
Minimum string length: 1

Response

Success

data
object
required
meta
object
required