---
title: "Fetch all job posts"
method: GET
path: "/jobs"
tags: ["Job Posts"]
---

# Fetch all job posts

`GET /jobs`

## Request

- Base URL: `https://staging.api-golang.boilerplate.hng.tech/api/v1`
- URL: `https://staging.api-golang.boilerplate.hng.tech/api/v1/jobs`
- Auth: none declared
- TypeScript: <https://skmtc.dev/hngprojects/apis/kimiko-golang-swagger/docs/jobs/get.ts> (a function with typed inputs; its response is checked against the schema)

Fetches all job posts with optional pagination.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

A list of paginated job posts

- JobPost[]
  - `id` string
  - `title` string
  - `salary_range` string
  - `job_type` string
  - `location` string
  - `deadline` string, date-time
  - `job_mode` string
  - `experience_level` string
  - `how_to_apply` string
  - `benefits` string
  - `company_name` string
  - `description` string
  - `key_responsibilities` string
  - `qualifications` string
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `404`: Jobs not found

## Changes

- **2024-08-08** `0e62b1539f9c`: 4 warning, 6 info
  - removed the optional property `items/experience` from the response with the `200` status
  - removed the optional property `items/job_benefits` from the response with the `200` status
  - removed the optional property `items/salary` from the response with the `200` status
  - removed the optional property `items/work_mode` from the response with the `200` status
  - …6 more
- **2024-08-07** `06cecc2ac126`: 4 warning, 6 info
  - removed the optional property `items/benefits` from the response with the `200` status
  - removed the optional property `items/experience_level` from the response with the `200` status
  - removed the optional property `items/job_mode` from the response with the `200` status
  - removed the optional property `items/salary_range` from the response with the `200` status
  - …6 more

[Operation history](https://skmtc.dev/hngprojects/apis/kimiko-golang-swagger/changes/jobs/get.md)

---

[API](https://skmtc.dev/hngprojects/apis/kimiko-golang-swagger.md) - [All operations](https://skmtc.dev/hngprojects/apis/kimiko-golang-swagger/llms.txt) - [OpenAPI document](https://skmtc.dev/hngprojects/apis/kimiko-golang-swagger/revisions/2d1d3ed96bb9?raw)