Retrieve

get/v1/workers/{id}

Get a specific worker by id.

Path ParametersExpand Collapse

id: string

The id of the worker.

ReturnsExpand Collapse

id: string

The id of the worker.

businessName: string

displayName: string

The "ui" name of a worker. If it's a business contractor business name is used. Otherwise we default to preferred name, then first-last.

email: string

An email with a reasonably valid regex (shamelessly taken from zod)

endDate: string

A date string in the form YYYY-MM-DD

firstName: string

isBusiness: boolean

lastName: string

position: string

preferredName: string

startDate: string

A date string in the form YYYY-MM-DD

status: "onboarding" or "active" or "offboarding" or "inactive"

Accepts one of the following:

"onboarding"

"active"

"offboarding"

"inactive"

timeZone: string

The IANA timezone of the worker (e.g., America/New_York).

type: "employee" or "contractor"

Accepts one of the following:

"employee"

"contractor"

workEmail: string

An email with a reasonably valid regex (shamelessly taken from zod)

curl https://api.joinwarp.com/v1/workers/$ID \
    -H "x-api-key: $WARP_API_KEY"

{
  "id": "wrk_1234",
  "businessName": null,
  "displayName": "Jack Galt",
  "email": "john@joinwarp.com",
  "endDate": "2000-01-01",
  "firstName": "Jonathan",
  "isBusiness": false,
  "lastName": "Galt",
  "position": "Research Engineer",
  "preferredName": "John",
  "startDate": "2000-01-01",
  "status": "onboarding",
  "timeZone": "America/New_York",
  "type": "employee",
  "workEmail": "john@joinwarp.com"
}

Returns Examples

{
  "id": "wrk_1234",
  "businessName": null,
  "displayName": "Jack Galt",
  "email": "john@joinwarp.com",
  "endDate": "2000-01-01",
  "firstName": "Jonathan",
  "isBusiness": false,
  "lastName": "Galt",
  "position": "Research Engineer",
  "preferredName": "John",
  "startDate": "2000-01-01",
  "status": "onboarding",
  "timeZone": "America/New_York",
  "type": "employee",
  "workEmail": "john@joinwarp.com"
}