Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Kombo Unified ATS (Assessment & Background Check) API API

Unified endpoints to operate Assessments and Background Checks for many applicant tracking systems.

Kombo Unified ATS (Assessment & Background Check) API API is one of 8 APIs that Kombo publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Unified ATS (Assessment & Background Check) API. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a getting-started guide.

This API exposes 5 operations across 4 paths, and defines 15 schemas. It is described by OpenAPI 3.1.0, at version 1.0.0.

Requests are made against 2 base URLs: https://api.kombo.dev/v1, https://api.us.kombo.dev/v1.

5 operations 4 paths 15 schemas 3 GET2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.1.0
API Version
1.0.0
Base URL
https://api.kombo.dev
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Kombo Unified ATS (Assessment & Background Check) API API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (ApiKey). By default, every request must be authenticated.

  • ApiKey — Create an API key on the [Secrets](https://app.kombo.dev/secrets) page in the Kombo dashboard.

Paths & Operations 5

Across 4 paths, the API surfaces 5 operations — 3 GET, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Unified ATS (Assessment & Background Check) API 5

Unified endpoints to operate Assessments and Background Checks for many applicant tracking systems.

GET
/assessment/packages
Get packages
GetAssessmentPackages 1 param → 200default
PUT
/assessment/packages
Set packages
PutAssessmentPackages 1 param body → 200default
GET
/assessment/orders
Get orders
GetAssessmentOrders 6 params → 200default
GET
/assessment/orders/open
Get open orders (deprecated)
GetAssessmentOrdersOpen 3 params → 200default
PUT
/assessment/orders/{assessment_order_id}/result
Update order result
PutAssessmentOrdersAssessmentOrderIdResult 2 params body → 200default

Schemas 15

The contract defines 15 schemas that model the data the API accepts and returns. The most detailed are PutAssessmentOrdersAssessmentOrderIdResultRequestBody (8 properties), PutAssessmentPackagesPositiveResponse (3 properties), PutAssessmentOrdersAssessmentOrderIdResultPositiveResponse (3 properties), GetAssessmentOrdersPositiveResponse (2 properties). Each schema is shown below with its type and property counts.

PutAssessmentOrdersAssessmentOrderIdResultRequestBody
object
8 properties 2 required
PutAssessmentPackagesPositiveResponse
object
3 properties 3 required
GetAssessmentPackagesPositiveResponse
object
2 properties 2 required
PutAssessmentPackagesRequestBody
object
1 property 1 required
GetAssessmentOrdersParameterCreatedAfter
string
Filter orders by their creation date-timestamp in the format: YYYY-MM-DDTHH:mm:ss.sssZ. Only orders created on or after this date-timestamp will be returned.
PutAssessmentOrdersAssessmentOrderIdResultParameterAssessmentOrderId
string
GetAssessmentOrdersOpenPositiveResponse
object
2 properties 2 required
PutAssessmentOrdersAssessmentOrderIdResultPositiveResponse
object
3 properties 3 required
GetAssessmentOrdersParameterCursor
string
An optional cursor string used for pagination. This can be retrieved from the next property of the previous page response.
GetAssessmentOrdersPositiveResponse
object
2 properties 2 required
GetAssessmentOrdersParameterIds
string
Filter by a comma-separated list of IDs such as 222k7eCGyUdgt2JWZDNnkDs3,B5DVmypWENfU6eMe6gYDyJG3.
GetAssessmentOrdersOpenParameterCursor
string
An optional cursor string used for pagination. This can be retrieved from the next property of the previous page response.
GetAssessmentOrdersParameterPageSize
integer
The number of results to return per page. Maximum is 250.
GetAssessmentOrdersParameterStatuses
string
Filter by a comma-separated list of OPEN, COMPLETED, CANCELLED, REJECTED. Leave this blank to get results matching all values.
GetAssessmentOrdersOpenParameterPageSize
integer
The number of results to return per page. Maximum is 250.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

kombo-unified-ats-assessment-background-check-api-api-openapi.yml Raw ↑

Other APIs Kombo publishes across the network.

Kombo AI Apply API
Kombo Custom Endpoints API
Kombo General API
Kombo Kombo Connect API
Kombo Unified ATS API API
Kombo Unified HRIS API API
Kombo Unified LMS API API