---
title: "List all jobs"
method: GET
path: "/ats/{connection_id}/job"
tags: ["ats", "job"]
---

# List all jobs

`GET /ats/{connection_id}/job`

## Request

- Base URL: `http://api.unified.to`
- URL: `http://api.unified.to/ats/{connection_id}/job`
- Auth: API key in header `authorization`

## Path parameters

- `connection_id` string, required

## Query parameters

- `limit` number
- `offset` number
- `updated_gte` string, date-time
- `sort` 'name' | 'updated_at' | 'created_at'
- `order` 'asc' | 'desc'
- `query` string
- `user_id` string
- `company_id` string
- `status` string
- `fields` string[]
- `raw` string

## Response `200`

Successful

- AtsJob[]
  - `id` string
  - `created_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `updated_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `name` string
  - `description` string
  - `recruiter_ids` string[]
  - `hiring_manager_ids` string[]
  - `hiring_managers` AtsReference[]
    - `id` string
    - `name` string
  - `status` 'ARCHIVED' | 'PENDING' | 'DRAFT' | 'OPEN' | 'CLOSED'
  - `closed_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
  - `addresses` AtsAddress[]
    - `address1` string
    - `address2` string
    - `city` string
    - `region` string: Regional area of the employee's address. For example, in the U.S., the region is the employee's state; in Canada, the region is the employee’s province.
    - `region_code` string: Short form for the regional area of the employee's address. For example, in the U.S., the region code is the two-letter abbreviation for the employee’s state; in Canada, the region is the two-letter abbreviation for the employee's province.
    - `postal_code` string
    - `country` string
    - `country_code` string: Country code for the country, in ISO 3166 A-2 format
  - `compensation` AtsCompensation[]
    - `type` 'SALARY' | 'BONUS' | 'STOCK_OPTIONS' | 'EQUITY' | 'OTHER'
    - `min` number
    - `max` number
    - `currency` string
    - `frequency` 'ONE_TIME' | 'DAY' | 'QUARTER' | 'YEAR' | 'HOUR' | 'MONTH' | 'WEEK'
  - `employment_type` 'FULL_TIME' | 'PART_TIME' | 'CONTRACTOR' | 'INTERN' | 'CONSULTANT' | 'VOLUNTEER' | 'CASUAL' | 'SEASONAL' | 'FREELANCE' | 'OTHER'
  - `remote` boolean
  - `language_locale` string: Preferred language for the job, in ISO 639-1 format (e.g., U.S. English is en-us)
  - `public_job_urls` string[]: URLs for pages containing public listings for the job
  - `number_of_openings` number: Number of openings for the job
  - `company_id` string: id value of the company associated with the job in the ATS (reference to AtsCompany)
  - `questions` AtsJobQuestion[]
    - `id` string
    - `question` string, required
    - `required` boolean
    - `description` string
    - `prompt` string
    - `type` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'MULTIPLE_CHOICE' | 'FILE' | 'TEXTAREA' | 'MULTIPLE_SELECT' | 'UNIVERSITY' | 'YES_NO' | 'CURRENCY' | 'URL', required
    - `options` string[]
    - `min_length` number: minimum answer length (TEXT)
    - `max_length` number: maximum answer length (TEXT)
    - `min_value` number: minimum answer value (NUMBER)
    - `max_value` number: maximum answer value (NUMBER)
    - `min_at` string, date-time: earliest allowed answer (DATE) (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `max_at` string, date-time: latest allowed answer (DATE) (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `parent_id` string: id of the question in this job's questions list that this question depends on
    - `parent_answer_values` string[]: only ask this question when the parent question's answer is one of these
  - `postings` AtsJobPosting[]: Public job postings
    - `id` string
    - `created_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `updated_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `posting_url` string
    - `name` string: job-post-specific name
    - `description` string: job-post-specific description
    - `address` AtsJobPostingAddress: job-post-specific address
      - `address1` string
      - `address2` string
      - `city` string
      - `region` string: Regional area of the employee's address. For example, in the U.S., the region is the employee's state; in Canada, the region is the employee’s province.
      - `region_code` string: Short form for the regional area of the employee's address. For example, in the U.S., the region code is the two-letter abbreviation for the employee’s state; in Canada, the region is the two-letter abbreviation for the employee's province.
      - `postal_code` string
      - `country` string
      - `country_code` string: Country code for the country, in ISO 3166 A-2 format
    - `location` string: job-post-specific location
    - `is_active` boolean
  - `groups` AtsGroup[]: The departments/divisions/teams that this job belongs to
    - `id` string
    - `name` string
    - `type` 'TEAM' | 'GROUP' | 'DEPARTMENT' | 'DIVISION' | 'BUSINESS_UNIT' | 'BRANCH' | 'SUB_DEPARTMENT'
  - `openings` AtsJobOpening[]
    - `status` 'OPEN' | 'CLOSED'
    - `opened_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `closed_at` string, date-time: (ISO-8601 / YYYY-MM-DDTHH:MM:SSZ format)
    - `application_id` string: points to an application
    - `close_reason` string
  - `minimum_experience_years` number
  - `minimum_degree` string
  - `skills` string[]
  - `metadata` AtsMetadata[]
    - `id` string
    - `slug` string: Actual textual value of the slug
    - `value` unknown
    - `namespace` string
    - `format` 'TEXT' | 'NUMBER' | 'DATE' | 'BOOLEAN' | 'FILE' | 'TEXTAREA' | 'SINGLE_SELECT' | 'MULTIPLE_SELECT' | 'MEASUREMENT' | 'PRICE' | 'YES_NO' | 'CURRENCY' | 'URL'
    - `extra_data` unknown
  - `user_id` string: User id of the job owner in the ATS (references an HRIS employee) (reference to HrisEmployee)
  - `industry` string
  - `summary` string: Short job blurb (distinct from full description when both exist)
  - `raw` unknown

---

[API](https://skmtc.dev/unified/apis/unified-to-api-2.md) · [All operations](https://skmtc.dev/unified/apis/unified-to-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/unified/apis/unified-to-api-2/revisions/7a38bdd7f089?raw)
