Skip to main content
GET
/
ats
/
jobs
Python
from kombo import SDK


with SDK(
    integration_id="workday:HWUTwvyx2wLoSUHphiWVrp28",
    api_key="<YOUR_BEARER_TOKEN_HERE>",
) as sdk:

    res = sdk.ats.get_jobs(page_size=100, include_deleted=False)

    while res is not None:
        # Handle items

        res = res.next()
{
  "status": "success",
  "data": {
    "next": "eyJwYWdlIjoxMiwibm90ZSI6InRoaXMgaXMganVzdCBhbiBleGFtcGxlIGFuZCBub3QgcmVwcmVzZW50YXRpdmUgZm9yIGEgcmVhbCBjdXJzb3IhIn0=",
    "results": [
      {
        "id": "H5daSm8e85Dmvmne3wLeCPhX",
        "remote_id": "32",
        "name": "Backend Engineer",
        "job_code": "BE-2021-01",
        "description": "<p>Kombo is hiring engineers! If you are reading this and you are located in Berlin, Germany, feel free to contact us about this position.</p>",
        "confidential": false,
        "weekly_hours": 37,
        "employment_type": "FULL_TIME",
        "status": "OPEN",
        "visibility": "PUBLIC",
        "category": "Technical Job",
        "department": "Engineering",
        "post_url": "https://jobs.example.com/post/159829112",
        "experience_level": "Mid-Senior",
        "remote_work_status": "HYBRID",
        "salary_amount": 4200,
        "salary_amount_from": null,
        "salary_amount_to": null,
        "salary_currency": "EUR",
        "salary_period": "MONTH",
        "location": {
          "city": "Berlin",
          "country": "DE",
          "raw": "Berlin, Germany",
          "state": "Berlin",
          "street_1": "Lohmühlenstraße 65",
          "street_2": null,
          "zip_code": "12435"
        },
        "custom_fields": {},
        "integration_fields": [],
        "remote_url": "https://app.greenhouse.io/jobs/32",
        "opened_at": "2022-08-07T14:01:29.196Z",
        "closed_at": null,
        "remote_created_at": "2022-08-07T14:01:29.196Z",
        "remote_updated_at": "2022-08-07T14:01:29.196Z",
        "contact_id": "6gT2yLMBEipd3zpezATv3Rhu",
        "remote_data": null,
        "changed_at": "2022-08-07T14:01:29.196Z",
        "remote_deleted_at": null,
        "stages": [
          {
            "id": "5J7L4b48wBfffYwek9Az9pkM",
            "remote_id": "32",
            "name": "Initial Screening",
            "remote_data": null,
            "index": 0
          }
        ],
        "screening_questions": [
          {
            "id": "26vafvWSRmbhNcxJYqjCzuJg",
            "remote_id": "48b4d36a-1d4b-4c50-ada7-9519078e65b4",
            "title": "Which is your primary programming language?",
            "description": "Please enter the language you are most comfortable with.",
            "format": {
              "display_type": "SINGLE_LINE",
              "max_length": null,
              "type": "TEXT"
            },
            "category": null,
            "index": 0,
            "required": true,
            "precondition_question_id": "4ZVteCSSgDw3BdwGzcQqGEPk",
            "precondition_options": [
              "7qd5qjPwDHarsMLFMGzXYG1K"
            ]
          }
        ],
        "job_postings": [
          {
            "id": "26vafvWSRmbhNcxJYqjCzuJg",
            "remote_id": "48b4d36a-1d4b-4c50-ada7-9519078e65b4",
            "title": "Frontend Engineer",
            "description_html": "<p>We are looking for a Frontend Engineer.</p>",
            "status": "ACTIVE",
            "visibility": "PUBLIC",
            "url": "https://jobs.example.com/post/159829112",
            "remote_data": null
          }
        ],
        "hiring_team": [
          {
            "id": "26vafvWSRmbhNcxJYqjCzuJg",
            "remote_id": "32",
            "first_name": "John",
            "last_name": "Doe",
            "email": "john.doe@kombo.dev",
            "hiring_team_roles": [
              "RECRUITER"
            ]
          }
        ]
      }
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Create an API key on the Secrets page in the Kombo dashboard.

Headers

​
X-Integration-Id
string
required

ID of the integration you want to interact with.

Query Parameters

​
cursor
string

An optional cursor string used for pagination. This can be retrieved from the next property of the previous page response.

​
page_size
integer
default:100

The number of results to return per page. Maximum is 250.

Required range: 1 <= x <= 250
​
updated_after
string<date-time>

Filter the entries based on the modification date in format YYYY-MM-DDTHH:mm:ss.sssZ. Returns records where either the record itself OR its nested data has been updated since this timestamp, even if the record's own changed_at field remains unchanged.

If you want to track entry deletion, also set the include_deleted=true query parameter, because otherwise, deleted entries will be hidden.

For more details, see Understanding changed_at vs updated_after Behavior.

​
include_deleted
enum<string>
default:false

By default, deleted entries are not returned. Use the include_deleted query param to include deleted entries too.

Available options:
true,
false
​
ids
string

Filter by a comma-separated list of IDs such as 222k7eCGyUdgt2JWZDNnkDs3,B5DVmypWENfU6eMe6gYDyJG3.

​
remote_ids
string

Filter by a comma-separated list of remote IDs.

​
job_codes
string

Filter by a comma-separated list of job codes.

​
post_url
string

Filter by the post_url field. Can be used to find a job based on its public posting URL.

​
status
enum<string>
deprecated

(⚠️ Deprecated - Use the statuses filter instead.) Filter by the status field. Can be used to find a job based on its status.

Available options:
OPEN,
CLOSED,
DRAFT,
ARCHIVED
​
statuses
string

Filter by a comma-separated list of OPEN, CLOSED, DRAFT, ARCHIVED

Leave this blank to get results matching all values.

​
employment_types
string

Filter by a comma-separated list of FULL_TIME, PART_TIME, CONTRACT, SEASONAL, INTERNSHIP

Leave this blank to get results matching all values.

​
visibilities
string

Filter by a comma-separated list of PUBLIC, INTERNAL, UNLISTED, CONFIDENTIAL

Leave this blank to get results matching all values.

​
remote_created_after
string<date-time>

Filter jobs by the day they were created in the remote system. This allows you to get jobs that were created on or after a certain day.

​
name_contains
string

Filter by the name field. Can be used to find a job by keywords present in the job name.

Response

GET /ats/jobs Positive response

​
status
string
required
Allowed value: "success"
​
data
object
required
Examples:
{
  "next": "eyJwYWdlIjoxMiwibm90ZSI6InRoaXMgaXMganVzdCBhbiBleGFtcGxlIGFuZCBub3QgcmVwcmVzZW50YXRpdmUgZm9yIGEgcmVhbCBjdXJzb3IhIn0=",
  "results": [
    {
      "id": "H5daSm8e85Dmvmne3wLeCPhX",
      "remote_id": "32",
      "name": "Backend Engineer",
      "job_code": "BE-2021-01",
      "description": "<p>Kombo is hiring engineers! If you are reading this and you are located in Berlin, Germany, feel free to contact us about this position.</p>",
      "confidential": false,
      "weekly_hours": 37,
      "employment_type": "FULL_TIME",
      "status": "OPEN",
      "visibility": "PUBLIC",
      "category": "Technical Job",
      "department": "Engineering",
      "post_url": "https://jobs.example.com/post/159829112",
      "experience_level": "Mid-Senior",
      "remote_work_status": "HYBRID",
      "salary_amount": 4200,
      "salary_amount_from": null,
      "salary_amount_to": null,
      "salary_currency": "EUR",
      "salary_period": "MONTH",
      "location": {
        "city": "Berlin",
        "country": "DE",
        "raw": "Berlin, Germany",
        "state": "Berlin",
        "street_1": "Lohmühlenstraße 65",
        "street_2": null,
        "zip_code": "12435"
      },
      "custom_fields": {},
      "integration_fields": [],
      "remote_url": "https://app.greenhouse.io/jobs/32",
      "opened_at": "2022-08-07T14:01:29.196Z",
      "closed_at": null,
      "remote_created_at": "2022-08-07T14:01:29.196Z",
      "remote_updated_at": "2022-08-07T14:01:29.196Z",
      "contact_id": "6gT2yLMBEipd3zpezATv3Rhu",
      "remote_data": null,
      "changed_at": "2022-08-07T14:01:29.196Z",
      "remote_deleted_at": null,
      "stages": [
        {
          "id": "5J7L4b48wBfffYwek9Az9pkM",
          "remote_id": "32",
          "name": "Initial Screening",
          "remote_data": null,
          "index": 0
        }
      ],
      "screening_questions": [
        {
          "id": "26vafvWSRmbhNcxJYqjCzuJg",
          "remote_id": "48b4d36a-1d4b-4c50-ada7-9519078e65b4",
          "title": "Which is your primary programming language?",
          "description": "Please enter the language you are most comfortable with.",
          "format": {
            "display_type": "SINGLE_LINE",
            "max_length": null,
            "type": "TEXT"
          },
          "category": null,
          "index": 0,
          "required": true,
          "precondition_question_id": "4ZVteCSSgDw3BdwGzcQqGEPk",
          "precondition_options": ["7qd5qjPwDHarsMLFMGzXYG1K"]
        }
      ],
      "job_postings": [
        {
          "id": "26vafvWSRmbhNcxJYqjCzuJg",
          "remote_id": "48b4d36a-1d4b-4c50-ada7-9519078e65b4",
          "title": "Frontend Engineer",
          "description_html": "<p>We are looking for a Frontend Engineer.</p>",
          "status": "ACTIVE",
          "visibility": "PUBLIC",
          "url": "https://jobs.example.com/post/159829112",
          "remote_data": null
        }
      ],
      "hiring_team": [
        {
          "id": "26vafvWSRmbhNcxJYqjCzuJg",
          "remote_id": "32",
          "first_name": "John",
          "last_name": "Doe",
          "email": "john.doe@kombo.dev",
          "hiring_team_roles": ["RECRUITER"]
        }
      ]
    }
  ]
}