---
title: "List job posts"
method: GET
path: "/api/v1/job/posts"
tags: ["Job::Posts"]
---

# List job posts

`GET /api/v1/job/posts`

## Request

- Base URL: `https://api.flexiple.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.flexiple.com/api/v1/job/posts`
- Auth: none declared

## Query parameters

- `skill_ids` integer[]
- `country_codes` string[]
- `job_type` 'contract' | 'full_time' | 'any'
- `client_account_id` integer
- `new_company_id` integer
- `designation` string
- `q` string
- `status` 'private' | 'published' | 'closed'
- `location_type` 'remote' | 'on_site' | 'hybrid'
- `assigned_to_me` boolean
- `sort_by` 'newest' | 'candidates_desc' | 'candidates_asc' | 'review_desc'
- `page` integer
- `page_size` integer

## Response `200`

OK with filters

- object
  - `data` JobPostWithList[], required
    - `id` integer, required
    - `client_id` integer
    - `new_company_id` integer
    - `job_slug` string, nullable, required
    - `designation` string, nullable, required
    - `location_type` 'remote' | 'on_site' | 'hybrid' | 'null', nullable, required
    - `status` 'private' | 'published' | 'closed', required
    - `job_type` 'contract' | 'full_time' | 'any', required
    - `published_at` string, date-time, nullable, required
    - `company_name` string
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `assignment_ids` string[], nullable
    - `hide_budget` boolean
    - `is_internal` boolean
    - `client_share_tag` string
    - `start_salary` object
      - `amount` number, required
      - `currency` string, required
      - `display_scale` number, required
      - `display_unit` string, required
      - `formatted_amount` number, required
      - `formatted` string, required
    - `end_salary` object
      - `amount` number, required
      - `currency` string, required
      - `display_scale` number, required
      - `display_unit` string, required
      - `formatted_amount` number, required
      - `formatted` string, required
    - `location` Location
      - `id` integer, required
      - `osm_id` integer, nullable, required
      - `osm_type` string, nullable, required
      - `city` string, nullable, required
      - `state` string, nullable, required
      - `country` string, nullable, required
      - `country_code` string, nullable, required
      - `formatted` string, required
      - `location_type` 'country' | 'state' | 'city', required
    - `skills` string[], required
    - `years_of_experience` string, required
    - `pipeline_counts` object, required
      - `total` number, required
      - `screening` number, required
      - `applicants` number, required
      - `agent_picks` number, required
      - `interview` number, required
      - `hired` number, required
      - `rejected` number, required
  - `meta` PaginationMeta, nullable
    - `total_count` integer
    - `total_pages` integer
    - `next_page` integer, nullable
    - `prev_page` integer, nullable
    - `current_page` integer
    - `page_size` integer

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1.md) - [All operations](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/revisions/27e7987859f2?raw)