List departments

This endpoint lets you retrieve all departments (aka teams) for a given organization. Departments are used on careers websites to organize job offers.

This endpoint requires departments_r or departments_rw scope.

departments list

GET https://www.welcomekit.co/api/v1/external/departments

Query Parameters

Name	Type	Description
organization_reference	string	Reference of the associated organization/company
per_page	integer	Number of jobs per page
page	integer	Page offset

200 Success

[
  {
    "id": 42,
    "name": "Tech",
    "is_active": true,
    "slug": "tech",
    "description": "Foo bar"
  }
]

Request example

curl -X GET -G "https://www.welcomekit.co/api/v1/external/departments" \
    -d "organization_reference=Pg4eV6k" \
    -H "Authorization: Bearer WK_API_KEY"