---
title: "Get job facets"
method: POST
path: "/v1/get_job_facets"
tags: ["jobs"]
---

# Get job facets

`POST /v1/get_job_facets`

## Request

- Base URL: `https://api.trylitos.com`
- URL: `https://api.trylitos.com/v1/get_job_facets`
- Auth: OAuth 2 (authorization code, authorization URL `https://api.trylitos.com/oauth/authorize`, token URL `https://api.trylitos.com/oauth/token`, scopes: `jobs:read`)

The companies and locations currently on the board, for narrowing a search.

## Request body

- object
  - `sponsor_only` 'true' | 'false'
  - `employment_type` 'Full-time' | 'Part-time' | 'Internship' | 'Apprenticeship' | 'Contract'
  - `counts` 'true' | 'false'

## Response `200`

The operation's result. Shapes mirror the Litos dashboard routes they proxy.

- object

## Other responses

- `4XX`: A refusal, carrying `error` (a sentence) and usually `code`.

---

[API](https://skmtc.dev/trylitos/apis/litos-api.md) · [All operations](https://skmtc.dev/trylitos/apis/litos-api/llms.txt) · [OpenAPI document](https://skmtc.dev/trylitos/apis/litos-api/revisions/d0ae6f04b1ae?raw)