Get jobs

GET

ats

jobs

Authorization

Header

Query

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

{
  "status": "success",
  "data": {
    "next": "eyJwYWdlIjoxMiwibm90ZSI6InRoaXMgaXMganVzdCBhbiBleGFtcGxlIGFuZCBub3QgcmVwcmVzZW50YXRpdmUgZm9yIGEgcmVhbCBjdXJzb3IhIn0=",
    "results": [
      {
        "id": "26vafvWSRmbhNcxJYqjCzuJg",
        "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"
        },
        "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",
        "changed_at": "2022-08-07T14:01:29.196Z",
        "remote_deleted_at": null,
        "stages": [
          {
            "id": "26vafvWSRmbhNcxJYqjCzuJg",
            "remote_id": "32",
            "name": "Initial Screening",
            "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
          }
        ],
        "job_postings": [
          {
            "id": "26vafvWSRmbhNcxJYqjCzuJg",
            "remote_id": "48b4d36a-1d4b-4c50-ada7-9519078e65b4",
            "description_html": "<p>We are looking for a Frontend Engineer.</p>",
            "status": "ACTIVE",
            "visibility": "PUBLIC"
          }
        ],
        "hiring_team": [
          {
            "id": "26vafvWSRmbhNcxJYqjCzuJg",
            "remote_id": "32",
            "first_name": "John",
            "last_name": "Doe",
            "email": "john.doe@kombo.dev",
            "hiring_team_roles": [
              "RECRUITER"
            ]
          }
        ]
      }
    ]
  }
}

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

headerrequired

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.

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. Those IDs are validated to be 24 characters long and to exist for this integration in the database. If any of the IDs are don't exist, the endpoint will return a 404 error.

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 - 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

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

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) 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

data.results.employment_type

required

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

required

One of 4 standardized values (OPEN, CLOSED, DRAFT, or ARCHIVED) or — in rare cases where can't find a clear mapping — the original string passed through.

Available options:

OPEN,

CLOSED,

DRAFT,

ARCHIVED

data.results.visibility

required

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

Useful if you are providing a job board and want to post public open jobs of your customers/partners. In rare cases where can't find a clear mapping, the original string is passed through.

Available options:

PUBLIC,

INTERNAL,

UNLISTED,

CONFIDENTIAL

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.remote_work_status

required

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

Available options:

REMOTE,

HYBRID,

TEMPORARY,

ON_SITE

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.salary_period

required

The period of the salary amount (not equal to the pay frequency).

Available options:

YEAR,

MONTH,

TWO_WEEKS,

WEEK,

DAY,

HOUR

data.results.location

object | null

required

The location of the listed job.

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) 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.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

Send passthrough request Get application stages

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

{
  "status": "success",
  "data": {
    "next": "eyJwYWdlIjoxMiwibm90ZSI6InRoaXMgaXMganVzdCBhbiBleGFtcGxlIGFuZCBub3QgcmVwcmVzZW50YXRpdmUgZm9yIGEgcmVhbCBjdXJzb3IhIn0=",
    "results": [
      {
        "id": "26vafvWSRmbhNcxJYqjCzuJg",
        "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"
        },
        "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",
        "changed_at": "2022-08-07T14:01:29.196Z",
        "remote_deleted_at": null,
        "stages": [
          {
            "id": "26vafvWSRmbhNcxJYqjCzuJg",
            "remote_id": "32",
            "name": "Initial Screening",
            "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
          }
        ],
        "job_postings": [
          {
            "id": "26vafvWSRmbhNcxJYqjCzuJg",
            "remote_id": "48b4d36a-1d4b-4c50-ada7-9519078e65b4",
            "description_html": "<p>We are looking for a Frontend Engineer.</p>",
            "status": "ACTIVE",
            "visibility": "PUBLIC"
          }
        ],
        "hiring_team": [
          {
            "id": "26vafvWSRmbhNcxJYqjCzuJg",
            "remote_id": "32",
            "first_name": "John",
            "last_name": "Doe",
            "email": "john.doe@kombo.dev",
            "hiring_team_roles": [
              "RECRUITER"
            ]
          }
        ]
      }
    ]
  }
}

General

Features

General API Reference

ATS API Reference

Authorizations

Headers

Query Parameters

Response

Option 1

Option 2

Option 3

Option 4

Option 5

Option 6

Option 7

Option 8

Option 9