List Job Post Questions

Retrieves a list of questions associated with a specific job post for the authenticated company. Use this endpoint before
job-posts/{job_post_id}/apply/ to build the answers array of an application.

Arguments

job_post_id (string, as path parameter) : The unique identifier (hash) of the job post to retrieve.

Example: job_post_id="d82f9a7c91b041b7b2b7612e"

Returns:

200 OK : An array of question objects related to the specified job post.

id (integer) : Pass this as job_post_question when submitting an answer.

question_text (string) : The question shown to the candidate.

is_required (boolean) : Required questions must be answered, otherwise the application is rejected with 400 Bad Request.

options (string, nullable) : Available options for single_choice and multiple_choice questions.

question_key (string, nullable) : Stable key of the question.

question_type (string, nullable) : Free-form marker set when the job post is created. Three values change how the
answer is handled: photo must be answered with answer_file (document ID), phone and address are answered with
answer. These three are written onto the candidate's photo, phone_number and address / city / country
instead of being stored as question answers. Any other value (for example linkedin_url, github_url,
portfolio_url, behance_url, dribbble_url, language, salary, or null) is stored as a normal answer; the
link related ones only affect which platform a detected URL is saved under.

404 Not Found : The job post does not exist or does not belong to the authenticated company.

Question IDs are unique per job post, so they must be read from this endpoint for every job post rather than hardcoded.

Example Response:

{
    "success": "OK",
    "content": [
        { "id": 91, "question_key": "photo", "question_text": "Photo", "answer_type": "file_upload", "options": null, "is_required": false, "question_type": "photo" },
        { "id": 92, "question_key": "phone", "question_text": "Phone number", "answer_type": "short_text", "options": null, "is_required": true, "question_type": "phone" },
        { "id": 93, "question_key": "address", "question_text": "Address", "answer_type": "short_text", "options": null, "is_required": false, "question_type": "address" },
        { "id": 94, "question_key": null, "question_text": "Share your GitHub profile", "answer_type": "url", "options": null, "is_required": false, "question_type": "github_url" }
    ]
}

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

List Job Post Questions

Request

Responses