Moves

It allows to create dashboard or analyze your candidate pipeline.

There are 3 types of moves:

  • a candidate moves from one job stage to another one (no job/organization change)

  • a candidate moves from one job to another one (no organization change)

  • a candidate moves from one job to another one from an another organization

Please note that a job stage is not included if it has been deleted after the move.

This endpoint requires moves_r scope.

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

Query Parameters

NameTypeDescription

organization_reference*

string

Reference of an organization/company involved in the move (from_organization and/or to_organization)

job_reference

string

Reference of a job involved in the move (from_job and/or to_job)

per_page

string

Number of jobs per page

page

integer

Page offset

[
  {
    "candidate": {"reference": "dc-41e24bb6e4a27"},
    "from": {
              "stage": {"id": 547, "name": "To meet", "reference": "to-meet"},
              "organization": {"reference": "wttj"},
              "job": {"reference": "V-1841-0"}
            },
    "to": {
            "stage": {"id": 295, "name": "Interviewed", "reference": "interviewed"},
            "organization": {"reference": "wttj"},
            "job": {"reference": "V-1841-0"}
          },
    "created_at": "2019-03-27T14:15:38.430+01:00",
    "updated_at": "2019-03-27T14:15:38.430+01:00"
  },
  ...
]

Request example

curl -X GET -G "https://www.welcomekit.co/api/v1/external/moves" \
    -d "organization_reference=wttj" \
    -d "job_reference=V-1841-0" \
    -H "Authorization: Bearer WK_API_KEY"

Last updated