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

NameTypeDescription

organization_reference

string

Reference of the associated organization/company

per_page

integer

Number of jobs per page

page

integer

Page offset

[
  {
    "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"

Last updated