---
title: "GET /api/v2/openings"
method: GET
path: "/api/v2/openings"
---

# GET /api/v2/openings

`GET /api/v2/openings`

## Request

- Base URL: `https://rolefig.com`
- URL: `https://rolefig.com/api/v2/openings`
- Auth: none declared

Every current public opening across companies, newest first (sort=pay for the best-paid first, by annual minimum in USD). The same expiry and self-service visibility rules as company reads. Follow nextCursor for the next page; a cursor belongs to its sort.

## Query parameters

- `q` string
- `workplace` string[]
- `type` string[]
- `country` string
- `region` string
- `company` string
- `postedWithin` 7 | 30
- `minPay` integer
- `sort` 'newest' | 'pay'
- `after` string
- `limit` integer

## Response `200`

A page of current openings, each a job summary; read the full posting from its company feed

- Openings
  - `version` '2', required
  - `openings` object[], required
    - `company` object, required
      - `slug` string, required
      - `name` string, required
      - `logoUrl` string
    - `job` object, required
      - `slug` string, required
      - `title` string, required
      - `department` string
      - `location` string, required
      - `addresses` object[]
        - `streetAddress` string
        - `locality` string, required
        - `region` string
        - `postalCode` string
        - `country` string, required
      - `remoteEligibility` object
        - `countries` string[], required
        - `regions` object[]
          - `country` string, required
          - `code` string, required
      - `workplaceType` 'remote' | 'hybrid' | 'on-site', required
      - `employmentType` 'full-time' | 'part-time' | 'contract', required
      - `compensation` object, required
        - `text` string, required
        - `currency` string
        - `min` number
        - `max` number
        - `unit` 'year' | 'month' | 'week' | 'day' | 'hour'
      - `datePosted` union
        - string, date
        - string, date-time
      - `applyUrl` string, required
  - `nextCursor` string, nullable, required

## Other responses

- `304`: Openings unchanged
- `400`: Invalid query or cursor
- `503`: Publishing unavailable; do not fall back to withdrawn content

---

[API](https://skmtc.dev/rolefig/apis/company-publishing-api.md) · [All operations](https://skmtc.dev/rolefig/apis/company-publishing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rolefig/apis/company-publishing-api/revisions/1927dc335cba?raw)