Get jobs

GET

ats

jobs

curl --request GET \
  --url https://api.kombo.dev/v1/ats/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Integration-Id: <x-integration-id>'

{
  "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": [],
        "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"
            },
            "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"
            ]
          }
        ]
      }
    ]
  }
}

Supported integrations

Visit our in depth guide to learn more about:

🔄 Getting updates of the data
❗ Handling failing syncs
🔍 Letting your customer choose which jobs to expose
🔗 Matching jobs in your database to ATS jobs
🗑️ Reacting to deleted/closed jobs

Top level filters use AND, while individual filters use OR if they accept multiple arguments. That means filters will be resolved like this: (id IN ids) AND (remote_id IN remote_ids)

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

Filter the entries based on the modification date in format YYYY-MM-DDTHH:mm:ss.sssZ. If you want to track entry deletion, also set the include_deleted=true query parameter, because otherwise, deleted entries will be hidden.

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

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

200

application/json

GET /ats/jobs Successful response

status

enum<string>

required

Available options:

success

data

object

required

data.next

string | null

required

Cursor string that can be passed to the cursor query parameter to get the next page. If this is null, then there are no more pages.

data.results

object[]

required

data.results.id

string

required

The globally unique ID of this object generated by Kombo. We recommend using this as a stable primary key for syncing.

data.results.remote_id

string

required

The raw ID of the object in the remote system. We don't recommend using this as a primary key on your side as it might sometimes be compromised of multiple identifiers if a system doesn't provide a clear primary key.

data.results.name

string | null

required

Title of the job.

data.results.job_code

string | null

required

The human readable job code. Some systems expose this as the Requisition Code/ID.

data.results.description

string | null

required

Description of the job. This field is usually returned as HTML.

data.results.confidential

boolean | null

required

deprecated

(⚠️ Deprecated) It makes more sense to store the visibility of a job in an enum. Therefore, we introduced the visibility enum on jobs.

data.results.weekly_hours

number | null

required

The number of hours per week an employee is expected to work.

data.results.category

string | null

required

The category of the job (often the job industry).

data.results.department

string | null

required

data.results.post_url

string | null

required

The public job posting URL of the ATS itself. This can be used by external job boards to redirect applicants.

data.results.experience_level

string | null

required

data.results.salary_amount

number | null

required

The salary amount in the given currency.

data.results.salary_amount_from

number | null

required

The lower bound of the salary range.

data.results.salary_amount_to

number | null

required

The upper bound of the salary range.

data.results.salary_currency

string | null

required

Salary currency usually returned in ISO 4217 currency codes.

data.results.custom_fields

object | null

required

A key-value store of fields not covered by the schema. Read more

data.results.integration_fields

object[]

required

An array of selected pass-through integration fields. Read more

Example:

[
  {
    "id": "5NVFhMpB9Ah6by44tzNjZLyE",
    "key": "firstName",
    "type": "DEFAULT",
    "value": "Frank",
    "label": "First Name"
  },
  {
    "id": "8nuajYpoRd5GnxEQaaWKUDYQ",
    "key": "customTshirtSize",
    "type": "CUSTOM",
    "value": "XL",
    "label": "T-Shirt Size"
  }
]

data.results.opened_at

string | null

required

YYYY-MM-DDTHH:mm:ss.sssZ

data.results.closed_at

string | null

required

YYYY-MM-DDTHH:mm:ss.sssZ

data.results.remote_created_at

string | null

required

The date and time the object was created in the remote system.

data.results.remote_updated_at

string | null

required

A timestamp retrieved from the remote system, describing when the resource was last updated.

data.results.contact_id

string | null

required

deprecated

(⚠️ Deprecated) The user ID of the contact person for this job. We strongly recommend using the new hiring_team property instead as it provides more complete and accurate information about the ATS users connected to a job.

data.results.remote_data

object | null

required

Includes the data fetched from the remote system. Please be aware that including this in you scope config might violate other scopes that are set.

Remote data always has the endpoint path that we got the data from as the top level key. For example, it could look like: { "/companies": { ... }}

This is not available on all plans. Reach out to Kombo if you need it.

data.results.changed_at

string

required

The timestamp when this object was last changed. This value is tracked by Kombo based on changes in the data.

data.results.remote_deleted_at

string | null

required

The date and time the object was deleted in the remote system. Objects are automatically marked as deleted when Kombo can't retrieve them from the remote system anymore. Kombo will also anonymize entries 14 days after they disappear.

data.results.stages

object[]

required

Application stages a candidate can be in for this particular job.

data.results.screening_questions

object[]

required

data.results.job_postings

object[]

required

data.results.hiring_team

object[]

required

The hiring team allows you to sync users into your system who can access the job and its applications.

data.results.employment_type

The type of employment contract. In rare cases where can't find a clear mapping, the original string is passed through.

Available options:

FULL_TIME,

PART_TIME,

CONTRACT,

SEASONAL,

INTERNSHIP

data.results.status

The job’s current status. In rare cases where we can’t find a clear mapping, the original string is passed through.

Available options:

OPEN,

CLOSED,

DRAFT,

ARCHIVED

data.results.visibility

Describes the visibility of the job:

PUBLIC: visible to everyone, published on a job board
INTERNAL: only visible to employees of the company itself
UNLISTED: anyone can apply but only if they have the link to it
CONFIDENTIAL: nobody can apply and it's only visible in the ATS to people who were invited to it

In rare cases where we can’t find a clear mapping, the original string is passed through.

Available options:

PUBLIC,

INTERNAL,

UNLISTED,

CONFIDENTIAL

data.results.remote_work_status

Defines if the job supports remote work and if so, to what extent.

Available options:

REMOTE,

HYBRID,

TEMPORARY,

ON_SITE

data.results.salary_period

The period of time over which the salary amount is paid (not equal to the pay frequency). In rare cases where we can’t find a clear mapping, the original string is passed through.

Available options:

YEAR,

MONTH,

TWO_WEEKS,

WEEK,

DAY,

HOUR

data.results.location

object | null

The location of the listed job.

Example:

{
  "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": [],
      "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"
          },
          "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"]
        }
      ]
    }
  ]
}

Partner Credentials Get application stages

curl --request GET \
  --url https://api.kombo.dev/v1/ats/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'X-Integration-Id: <x-integration-id>'

{
  "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": [],
        "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"
            },
            "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"
            ]
          }
        ]
      }
    ]
  }
}

General

Features

Guides

ATS API Reference

General API Reference

Authorizations

Headers

Query Parameters

Response