Changelog

Changes to the Jooble ATS Integration API, newest first.

5 October 2026

Summary

Get Candidates

GET /AtsJob/appliesByJob/{jobId}

Added

• applicant.education: array of the candidate’s education entries.

  Field	Type	Description
  institution	string?	Institution name
  level	string?	Education level, as shown to the candidate
  major	string?	Field of study
  yearOfGraduation	int?	Graduation year

• applicant.workExperience: array of the candidate’s work experience entries.

  Field	Type	Description
  title	string?	Position
  employer	string?	Company name
  responsibilities	string?	Responsibilities, free text
  startDate	string?	Start date, as entered by the candidate (e.g. "2025-01-01")
  endDate	string?	End date. null means the candidate still works there

• jobTitle: title of the job the candidate applied to.

Both arrays are always present and are empty ([]) when the candidate has no entries. Every field inside an entry can be null.

Changed

• cvFile is returned for every account. A separate ATS integration setting is no longer required.
• cvFile is omitted when the candidate has no CV. It was previously returned as null. Treat a missing cvFile and a null one the same way.

Updated response

A candidate object after this release:

[
  {
    "id": "649241",
    "isNew": true,
    "isViewed": false,
    "fileName": null,
    "date": "2026-09-24T11:35:38Z",
    "dateStatusChanged": "2026-09-24T11:35:38Z",
    "applicant": {
      "gender": "MALE",
      "name": "John Smith",
      "age": "30",
      "salary": "120000",
      "region": "Kyiv",
      "currency": "UAH",
      "isReadyForRelocate": false,
      "contacts": {
        "phone": "+380631234567",
        "email": "john.smith@example.com",
        "openDate": null,
        "isOpened": true
      },
      "education": [
        {
          "institution": "Imperial College London",
          "level": "Bachelor",
          "major": "Computer Science",
          "yearOfGraduation": 2020
        }
      ],
      "workExperience": [
        {
          "title": "QA Automation Engineer",
          "employer": "Acme",
          "responsibilities": "Test automation",
          "startDate": "2025-01-01",
          "endDate": null
        }
      ]
    },
    "jobId": 41927,
    "jobTitle": "QA Engineer",
    "cvFile": {
      "name": "resume.pdf",
      "data": "JVBERi0xLjQKMSAwIG9iago8P...",
      "type": "CV",
      "contentType": "application/pdf"
    }
  }
]

Create Job and Update Job

POST /AtsJob/create, PUT /AtsJob/update

Added

• currencyId (int, optional): salary currency. Allowed values are 0, 1 and 2; any other value returns 400 Bad Request.

If currencyId is omitted, 0 is used: UAH in Ukraine, EUR in Romania and HUF in Hungary. This also applies to Update Job: an update without currencyId sets the currency back to 0, so send currencyId on every update if the job uses another currency.

Get Job and Get All Jobs

GET /AtsJob/{id}, GET /AtsJob/allJobs

Added

• url: link to the job on the Jooble website, returned for every account on both endpoints. The field is omitted until the job has been published.

What to do before 5 October

Questions about this release? Contact your Jooble account manager.