---
title: Job Positions API
slug: list-job-positions
url: https://apyverse.com/sharpapi/service/list-job-positions
provider: SharpAPI
categories: [HR]
auth: api_key
---

# Job Positions API

List job positions with optional name filtering and related roles. Returns pagination metadata plus ids, names, slugs, and related weights.

## Endpoints

| Method | Path | Description | Atoms |
| --- | --- | --- | --- |
| GET | `/sharpapi/api/v1/utilities/job_positions_list` | What it does Returns a paginated list of job positions as a JSON object. You can filter the list by… | 1000 |

## About

## What it does
Job Positions Directory lets you list job position records and page through them with standard pagination metadata. Send an optional `name` query to filter by position name, set `per_page` to control the page size, and use `include_related` when you also want related roles with relevancy weights.

The response returns a `data` array of job positions. Each item includes `id`, `name`, and `slug`. When `include_related` is true, each position can also include `related_job_positions`, with each related item exposing its own `id`, `name`, `slug`, and `weight`.

You also get pagination context in `meta` and `links`, including `total`, `per_page`, `current_page`, `last_page`, `from`, `to`, and navigation URLs such as `first`, `last`, `next`, and `prev`. That makes it straightforward to build browse pages, internal role catalogs, or autocomplete flows that need both the current results and page navigation state.

Use Job Positions Directory when you need a structured list of job titles for filtering, UI selection, or enrichment of hiring and HR workflows.

## Usage

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyverse.com/sharpapi/service/list-job-positions