---
title: "Get orders"
method: GET
path: "/assessment/orders"
tags: ["Unified ATS (Assessment & Background Check) API"]
---

# Get orders

`GET /assessment/orders`

Get all assessment and background check orders of an integration.

## 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 — The number of results to return per page. Maximum is 250.
- `ids` string — Filter by a comma-separated list of IDs such as `222k7eCGyUdgt2JWZDNnkDs3,B5DVmypWENfU6eMe6gYDyJG3`.
- `statuses` string — Filter by a comma-separated list of `OPEN`, `COMPLETED`, `CANCELLED`, `REJECTED`. Leave this blank to get results matching all values.
- `created_after` string, date-time — 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.

## Headers

- `X-Integration-Id` string, required

## Response `200`

GET /assessment/orders Positive response

- GetAssessmentOrdersPositiveResponse
  - `status` 'success', required
  - `data` object, required
    - `next` string, nullable, required
    - `results` object[], required
      - `id` string, required — The unique identifier of the assessment order.
      - `package_id` string, required — The identifier of the assessment package.
      - `status` 'OPEN' | 'COMPLETED' | 'CANCELLED' | 'REJECTED', required — The current status of the assessment order.
      - `candidate` object, required — Information about the candidate taking the assessment.
        - `remote_id` string, nullable, required — The candidate's identifier in the integrated system.
        - `email` string, email, required — The candidate's email address.
        - `first_name` string, nullable, required — The candidate's first name.
        - `last_name` string, nullable, required — The candidate's last name.
        - `phone` string, nullable, required — The candidate's phone number.
      - `application` object, required — Information about the job application.
        - `remote_id` string, nullable, required — The application's identifier in the integrated system.
      - `job` object, required — Information about the job posting.
        - `remote_id` string, nullable, required — The job's identifier in the integrated system.
        - `name` string, nullable, required — The job title.
        - `job_code` string, nullable, required — The human readable job code. Some systems expose this as the Requisition Code/ID.
        - `description` string, nullable, required — Description of the job. This field is usually returned as HTML.
        - `location` object, nullable, required — The job location information.
          - `street_1` string, nullable — If we can parse the address data, this field contains the first part of the street information.
          - `street_2` string, nullable
          - `city` string, nullable
          - `state` string, nullable
          - `zip_code` string, nullable
          - `country` string, nullable — Contains the ISO2 country code if possible. If not, it contains the original value.
          - `raw` string, nullable — If we have address data, this is filled with the raw address string.
        - `hiring_team` object[], required — The hiring team allows you to provision users into your system who can access the job and its applications.
          - `remote_id` string, nullable, required — The team member's identifier in the integrated system.
          - `email` string, nullable, required — The team member's email address.
          - `first_name` string, nullable, required — The team member's first name.
          - `last_name` string, nullable, required — The team member's last name.
          - `hiring_team_roles` string[], required — Array of the roles of the user for this specific job.

## Other responses

- `default` — The standard error response with the error codes for the ATS use case.

---

[API](https://skmtc.net/kombo/apis/kombo-api.md) · [All operations](https://skmtc.net/kombo/apis/kombo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kombo/kombo-api/revisions/149bf44faf1a/schema)