Apply Job

Allows a candidate to apply for a specific job post by submitting application details and required information.

Arguments

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

Example: job_post_id="d82f9a7c91b041b7b2b7612e"

email (string, as body parameter) : Candidate's email address.

Example: "johndoe@example.com"

first_name (string, as body parameter) : Candidate's first name.

Example: "John"

last_name (string, as body parameter) : Candidate's last name.

Example: "Doe"

cv (string, as body parameter) : Document ID of uploaded candidate CV via utilities/upload-file/ endpoint.

Example: "20170"

terms_of_use (boolean, as body parameter, optional) : Whether candidate accepted terms of use.

answers (array, as body parameter) : Array of job application answers

Answer Formats

Education Answer JSON

[
{
    "school_name": "string",
    "degree": ["high_school_diploma", "associate_degree", "bachelors_degree", "masters_degree", "doctorate_degree", "certificate_or_diploma"],
    "major": "string",
    "start_date": "2014-04-07",
    "end_date": "2014-04-07",
    "currently_pursuing": true | false
}
]

Experience Answer JSON

[
{
    "company_name": "string",
    "position_title": "string", 
    "employment_type": ["full_time", "part_time", "contract", "intern"],
    "start_date": "2014-04-07",
    "end_date": "2014-04-07",
    "currently_employed": true | false
}
]

Example Answers

answers (body, array) : Comprehensive example of different question types
Example:

[
{
    "job_post_question": {"id": 1, "question_key": "Phone"},
    "answer": "+1234567890"
},
{
    "job_post_question": {"id": 2, "question_key": "Experience"},
    "answer": "[{"company_name":"Acme Corp", "position_title":"Developer", "employment_type":"full_time", "start_date":"2020-01-15", "end_date":"2023-12-31", "currently_employed":false}]"
},
{
    "job_post_question": {"id": 3, "question_key": "Education"},
    "answer": "[{"school_name":"Tech University", "degree":"bachelors_degree", "major":"Computer Science", "start_date":"2016-09-01", "end_date":"2020-06-30", "currently_pursuing":false}]"
},
{
    "job_post_question": {"id": 4, "question_key": "Photo"},
    "answer_file": "(file upload)"
}
]

Returns

201 Created : A success response indicating the job application was submitted successfully.

Returns a JSON object with a success message.

400 Bad Request : If there are validation errors (e.g., missing required questions, invalid data)

409 Conflict : If the user has already applied to this job post

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Request

Responses