---
title: "Open positions"
method: GET
path: "/api/v1/jobs"
tags: ["Public read (v1)"]
---

# Open positions

`GET /api/v1/jobs`

## Request

- Base URL: `https://dribba.com`
- URL: `https://dribba.com/api/v1/jobs`
- Auth: none required

Current openings with location, requirements and salary band. Paginated: pass `limit` to slice it and follow `next_cursor` until it is null.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Open positions

- JobList: Paginated openings.
  - `count` integer, required: Items in this page.
  - `total` integer, required: Items in the whole collection.
  - `next_cursor` string, nullable, required: Cursor for the next page, or null when there are no more items. Opaque: pass it back verbatim.
  - `items` Job[], required
    - `slug` string, required
    - `title` string, required
    - `url` string, uri, required
    - `area` string
    - `type` string
    - `location` string, required
    - `description` string
    - `requirements` string[]
    - `publishedAt` string, date, nullable
    - `salary` object
      - `currency` string
      - `min` integer
      - `max` integer
      - `period` 'YEAR'

## Other responses

- `404`: The route or the resource does not exist
- `405`: Method not supported by this endpoint
- `429`: Rate limit exceeded
- `500`: Unexpected server error

---

[API](https://skmtc.dev/dribba/apis/dribba-public-api.md) · [All operations](https://skmtc.dev/dribba/apis/dribba-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dribba/apis/dribba-public-api/revisions/694a12831fd4?raw)
