Vacancy Questions

Endpoint that provides a vacancies custom questions and questionnaire

Get Vacancy Custom Questions and Questionnaire

In order to access this endpoint ensure that you do a GET request with an Authorization header containing your access token.

Parameters:
id: string - id of the vacancy
Headers:
Authorization : {token}

Result Codes

403 Forbidden
200 OK
400 Bad request
500 Internal server error

Response

Calling this endpoint will a list of Custom Questions and a Questionnaire for the vacancy associated with the Id

Field

Type

Description

VacancyId

int

Vacancy Id

CustomQuestions

array

List of Custom Questions for a Vacancy

Questionnaire

object

Questionnaire for a Vacancy

Custom Question

Field

Type

Description

Id

int

Question Id

Question

string

Question field

VacancyId

int

Id associated with Vacancy

Type

int

1 = Text
2 = Radio Buttons
3 = Check Boxes
4 = Paragraph

RequirementType

int

1 = Required
2 = Optional
3 = Off

Rank

int

Order

Options

array

See Custom Question Option Below. Only applies to Radio Button an Check Box Questions

Custom Question Option

Field

Type

Description

QuestionId

int

Id associated with Question

Option

string

Option field

MoveTo

int

Move candidate to
null = Applied
2 = Shortlist
3 = Interview
4 = Feedback
6 = Disqualified

Score

Questionnaire

Id

int

Title

string

Title of questionnaire

VacancyId

int

Id of associated vacancy

Questions

array

See Questionnaire Question

Questionnaire Question

Id

int

QuestionnaireId

int

Id associated with Questionnaire

Question

string

Question field

Type

int

1 = Text
2 = Radio Buttons
3 = Check Boxes
4 = Paragraph

Order

int

Order displayed

Required

int

Is answer required

Options

array

See Questionnaire Option

Questionnaire Question Option

Field

Type

Description

Id

int

QuestionId

int

Id associated with Question

Answer

string

Answer field

Move

int

Move candidate to
0 = Do not move
3 = Disqualified
4 = Shortlist

Score

int

Score based on option

{
  "VacancyId": 23051,
  "CustomQuestions": [
    {
      "Id": 29013,
      "Question": "Text type question",
      "VacancyId": 23051,
      "Type": 1,
      "RequirementType": 1,
      "Rank": 1,
      "Options": []
    },
    {
      "Id": 29014,
      "Question": "Radio button type question",
      "VacancyId": 23051,
      "Type": 2,
      "RequirementType": 2,
      "Rank": 2,
      "Options": [
        {
          "Id": 57822,
          "QuestionId": 29014,
          "Option": "Move to Applied option",
          "Answer": null,
          "MoveTo": null,
          "Score": null
        },
        {
          "Id": 57823,
          "QuestionId": 29014,
          "Option": "Move to Disqualified option",
          "Answer": null,
          "MoveTo": 6,
          "Score": null
        },
        {
          "Id": 57824,
          "QuestionId": 29014,
          "Option": "Move to Shortlist option",
          "Answer": null,
          "MoveTo": 2,
          "Score": null
        },
        {
          "Id": 57825,
          "QuestionId": 29014,
          "Option": "Move to Feedback option",
          "Answer": null,
          "MoveTo": 4,
          "Score": null
        },
        {
          "Id": 57826,
          "QuestionId": 29014,
          "Option": "Move to Interview option",
          "Answer": null,
          "MoveTo": 3,
          "Score": null
        }
      ]
    }
  ],
  "Questionnaire": {
    "Id": 3739,
    "Title": "Questionnaire Example",
    "VacancyId": 23051,
    "Questions": [
      {
        "Id": 22414,
        "QuestionnaireId": 3739,
        "Question": "Text type question",
        "Type": 1,
        "Order": 1,
        "Required": true,
        "Options": []
      },
      {
        "Id": 22415,
        "QuestionnaireId": 3739,
        "Question": "Radio button type question",
        "Type": 2,
        "Order": 2,
        "Required": true,
        "Options": [
          {
            "Id": 54170,
            "QuestionId": 22415,
            "Answer": "Move to Shortlisted option",
            "MoveTo": 4,
            "Score": 60
          },
          {
            "Id": 54171,
            "QuestionId": 22415,
            "Answer": "Move to Disqualified option",
            "MoveTo": 3,
            "Score": 0
          },
          {
            "Id": 54172,
            "QuestionId": 22415,
            "Answer": "Option",
            "MoveTo": 0,
            "Score": 0
          }
        ]
      },
      {
        "Id": 22416,
        "QuestionnaireId": 3739,
        "Question": "Check box type question",
        "Type": 3,
        "Order": 3,
        "Required": true,
        "Options": [
          {
            "Id": 54173,
            "QuestionId": 22416,
            "Answer": "Option",
            "MoveTo": 0,
            "Score": 33
          },
          {
            "Id": 54174,
            "QuestionId": 22416,
            "Answer": "Move to Shortlisted option",
            "MoveTo": 4,
            "Score": 33
          },
          {
            "Id": 54175,
            "QuestionId": 22416,
            "Answer": "Move to Disqualified option",
            "MoveTo": 3,
            "Score": 33
          }
        ]
      },
      {
        "Id": 22417,
        "QuestionnaireId": 3739,
        "Question": "Paragraph type question",
        "Type": 4,
        "Order": 4,
        "Required": false,
        "Options": []
      }
    ]
  }
}