Skip to main content
GET
Get a person

Authorizations

X-API-Key
string
header
required

Organization-scoped API key. Create one in the BuildingSwell app under Organization settings, API keys.

Path Parameters

id
string<uuid>
required

Record id.

Query Parameters

select
string[]

Fields to return. Comma-separated or repeated parameters are equivalent; an explicit selection includes only requested fields. Nested JSON paths are supported.

Response

The person.

value
object
required

Your workforce roster. Use it to resolve the workerId values that appear on timesheets, assignments, and QC entries.