Get applications

Supported integrations

This feature is currently available for the following integrations:

You’d like to see this feature for another integration? Please reach out! We’re always happy to discuss extending our coverage.

Visit our in-depth guides to learn more about:

💡 Being aware of which applications are tracked
🚦 Hiring signals
📈 Application stage changes
❓ ATS-specific limitations

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

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.

outcome

enum<string>

deprecated

(⚠️ Deprecated - Use the outcomes filter instead.) Filter applications by outcome. This allows you to get applications that are for example PENDING, HIRED, or DECLINED.

Available options:

PENDING,

HIRED,

DECLINED

outcomes

string

Filter by a comma-separated list of PENDING, HIRED, DECLINED

PENDING: The application is still being processed.
HIRED: The candidate was hired.
DECLINED: The candidate was declined.

Leave this blank to get results matching all values.

job_ids

string

Filter by a comma-separated list of job IDs. We will only return applications that are related to any of the jobs.

job_remote_ids

string

Filter by a comma-separated list of job remote IDs. We will only return applications that are related to any of the jobs.

current_stage_ids

string

Filter by a comma-separated list of application stage IDs. We will only return applications that are currently in any of the stages.

remote_created_after

string<date-time>

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

Response

GET /ats/applications Positive response

status

string

required

Allowed value: "success"

data

object

required

Show child attributes

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

Show child attributes

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

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

enum<string> | null

required

Parsed status of the application. If Kombo identifies that the application was accepted and the candidate hired, it will be HIRED. If the application was rejected or the candidate declined, it will be DECLINED. If the application is still in process, it will be PENDING. Kombo will always try to deliver this information as reliably as possible.

Available options:

PENDING,

HIRED,

DECLINED

data.results.rejection_reason_name

string | null

required

Reason for the rejection of the candidate.

data.results.rejected_at

string<date-time> | null

required

The time that the application was rejected.

data.results.current_stage_id

string | null

required

ID of the current application stage

data.results.job_id

string | null

required

The Kombo ID of the job which the candidate applied to. The ID can be used to retrieve the job from the get jobs endpoint.

data.results.candidate_id

string | null

required

The Kombo ID of the candidate who applied to the job. The ID can be used to retrieve the candidate from the get candidates endpoint.

data.results.custom_fields

object

required

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

data.results.integration_fields

object[]

required

An array of selected passthrough integration fields. Read more

Show child attributes

data.results.integration_fields.id

string

required

The globally unique ID of this object.

data.results.integration_fields.key

string

required

The key of the field in the remote system.

data.results.integration_fields.type

enum<string>

required

DEFAULT: static fields in the remote system.
CUSTOM: fields that are created/editable by the user.

Available options:

DEFAULT,

CUSTOM

data.results.integration_fields.label

string | null

required

The label of the field. (not always available)

data.results.integration_fields.value

null

The field's value.

data.results.remote_url

string<uri> | null

required

URL to the application in the source ATS system. When embedding this in your system, please consider that not for all ATS a dedicated application URL is available, so you might need to fall back to the candidate URL.

data.results.changed_at

string<date-time>

required

The timestamp when this specific record was last modified. This field only updates when properties directly on this record change, NOT when related or nested models change. For filtering that considers nested data changes, use the updated_after parameter which will return records when either the record itself OR its related models have been updated.

data.results.remote_deleted_at

string<date-time> | 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.remote_created_at

string<date-time> | null

required

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

data.results.remote_updated_at

string<date-time> | null

required

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

data.results.remote_data

object

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

object

required

Show child attributes

data.results.candidate.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.candidate.remote_id

string

required

data.results.candidate.first_name

string | null

required

First name of the candidate.

data.results.candidate.last_name

string | null

required

Last name of the candidate.

data.results.candidate.source

string | null

required

The hiring source of the candidate. If you're a job board or recruiting service, you can use this to validate which candidates applied through your service and ensure that the correct referral compensation is paid out.

data.results.candidate.remote_url

string<uri> | null

required

URL to the candidate profile in the source ATS system. When embedding this in your system, please consider that not for all ATS a dedicated candidate profile URL is available, so you might need to fall back to the application URL.

data.results.candidate.tags

object[]

required

Show child attributes

data.results.candidate.tags.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.candidate.tags.remote_id

string | null

required

data.results.candidate.tags.name

string | null

required

data.results.candidate.email_addresses

object[] | null

A list of email addresses of the candidate with an optional type. If an email address is invalid, it will be filtered out.

Show child attributes

data.results.candidate.email_addresses.type

string | null

required

Kombo exposes type information through this field. If we don't get any information from the tool, we will set this to null.

data.results.candidate.email_addresses.email_address

string | null

data.results.candidate.phone_numbers

object[] | null

A list of phone numbers of the candidate.

Show child attributes

data.results.candidate.phone_numbers.phone_number

string

required

data.results.candidate.phone_numbers.type

string | null

Kombo exposes type information through this field. If we don't get any information from the tool, we will set this to null.

List of social media accounts of the candidate.

Show child attributes

data.results.current_stage

object

required

Show child attributes

data.results.current_stage.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.current_stage.remote_id

string | null

required

data.results.current_stage.name

string | null

required

The application stage name. For example, "Initial Screening".

data.results.current_stage.index

integer<int64> | null

required

data.results.job

object

required

Show child attributes

data.results.job.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.job.remote_id

string

required

data.results.job.name

string | null

required

Title of the job.

data.results.interviews

object[]

required

Show child attributes

data.results.interviews.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.interviews.remote_id

string | null

required

data.results.interviews.title

string | null

required

The title of the interview.

data.results.interviews.starting_at

string<date-time> | null

required

The start time of the interview.

data.results.interviews.ending_at

string<date-time> | null

required

The end time of the interview.

data.results.interviews.canceled

boolean | null

required

Whether the interview was canceled or not. If we have no information, this field will be null.

data.results.interviews.location

object

Location of the interview.

Show child attributes

data.results.interviews.location.city

string | null

data.results.interviews.location.country

string | null

Contains the ISO2 country code if possible. If not, it contains the original value.

data.results.interviews.location.raw

string | null

If we have address data, this is filled with the raw address string.

data.results.interviews.location.state

string | null

data.results.interviews.location.street_1

string | null

If we can parse the address data, this field contains the first part of the street information.

data.results.interviews.location.street_2

string | null

data.results.interviews.location.zip_code

string | null

data.results.offers

object[]

required

Show child attributes

data.results.offers.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.offers.remote_id

string | null

required

data.results.offers.status

enum<string> | null

required

The offer’s current status. The usual flow of statuses is as follows: DRAFT -> APPROVED -> SENT -> ACCEPTED or DECLINED.

Please note that not all systems will expose all statuses. For example, most systems do not include the APPROVED status

ACCEPTED: The offer was accepted by the candidate.
DECLINED: The offer was declined by the candidate.
SENT: The offer was sent to the candidate.
APPROVED: The draft was approved.
DRAFT: The offer is a draft and has not yet been sent to the candidate.
ABANDONED: The offer has expired or is no longer valid and should not be considered.

Available options:

ACCEPTED,

DECLINED,

SENT,

APPROVED,

DRAFT,

ABANDONED

data.results.screening_question_answers

object[] | null

A list of answers to screening questions. The screening answer type FILE is currently unsupported.

Option 1
Option 2
Option 3
Option 4
Option 5
Option 6
Option 7

Show child attributes

data.results.screening_question_answers.answer

object

required

Show child attributes

data.results.screening_question_answers.answer.content

string | null

required

data.results.screening_question_answers.question

object

required

Show child attributes

data.results.screening_question_answers.question.remote_id

string | null

required

data.results.screening_question_answers.question.title

string

required

data.results.screening_question_answers.question.type

string

required

Allowed value: "TEXT"

General

Features

Guides

ATS API Reference

General API Reference

Get applications

Authorizations

Headers

Query Parameters

Response