PeopleForce
Employees

List employees

GET
/api/public/v3/employees

Query Parameters

created_at[gte]?integer

Unix epoch seconds

Formatint64
created_at[lte]?integer

Unix epoch seconds

Formatint64
emails[]?array<string>
employee_numbers[]?array<string>
fields[]?array<string>
hired_on[gte]?string
Formatdate
hired_on[lte]?string
Formatdate
ids[]?array<>
legal_entity_id?integer
Formatint64
manager_id?integer
Formatint64
page?integer

Which page of results to return. Defaults to 1.

Formatint32
Range1 <= value
status?string
Default"active"

Value in

  • "active"
  • "employed"
  • "terminated"
  • "hired"
  • "probation"
  • "all"
updated_at[gte]?integer

Unix epoch seconds

Formatint64
updated_at[lte]?integer

Unix epoch seconds

Formatint64

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/api/public/v3/employees"
{  "data": [    {      "id": 0,      "status": "string",      "access": true,      "employee_number": "string",      "full_name": "string",      "first_name": "string",      "middle_name": "string",      "last_name": "string",      "avatar_url": "string",      "email": "string",      "mobile_number": "string",      "work_phone_number": "string",      "personal_email": "string",      "date_of_birth": "2019-08-24",      "probation_ends_on": "2019-08-24",      "hired_on": "2019-08-24",      "gender": {        "id": 0,        "name": "string"      },      "legal_entity": {        "id": 0,        "name": "string"      },      "position": {        "id": 0,        "name": "string"      },      "job_level": {        "id": 0,        "name": "string"      },      "location": {        "id": 0,        "name": "string"      },      "employment_type": {        "id": 0,        "name": "string"      },      "division": {        "id": 0,        "name": "string"      },      "job_profile": {        "id": 0,        "name": "string"      },      "department": {        "id": 0,        "name": "string",        "parent_id": 0,        "manager_id": 0,        "department_level": {          "id": 0,          "name": "string",          "hex_color": "string"        },        "created_at": "2019-08-24T14:15:22Z",        "updated_at": "2019-08-24T14:15:22Z",        "fields": {          "property1": {            "name": "string",            "value": "string"          },          "property2": {            "name": "string",            "value": "string"          }        }      },      "reporting_to": {        "id": 0,        "first_name": "string",        "last_name": "string",        "email": "string"      },      "created_at": "2019-08-24T14:15:22Z",      "updated_at": "2019-08-24T14:15:22Z",      "termination_effective_on": "2019-08-24",      "termination_comment": "string",      "termination_eligible_for_rehire": true,      "termination_type": {        "id": 0,        "name": "string"      },      "termination_reason": {        "id": 0,        "name": "string"      },      "fields": {        "property1": {          "label": "string",          "group": {            "id": 0,            "name": "string"          },          "value": [            "string"          ],          "option_id": 0,          "option_ids": [            0          ],          "user_id": 0        },        "property2": {          "label": "string",          "group": {            "id": 0,            "name": "string"          },          "value": [            "string"          ],          "option_id": 0,          "option_ids": [            0          ],          "user_id": 0        }      }    }  ],  "metadata": {    "pagination": {      "page": 0,      "pages": 0,      "count": 0,      "items": 0    }  }}