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

# Job Positions API

List job positions with ids, names, slugs, and pagination metadata. Optionally include related roles with relevancy weights for HR and hiring tools.

## Endpoints

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

## About

## What it does
Job Position Directory returns a paginated list of job positions with stable identifiers, names, and URL-friendly slugs. Send optional query parameters to filter by `name`, control `per_page`, and include related roles when you need a richer view of the job taxonomy.

Use it when you need a canonical source of role names for hiring flows, onboarding forms, search autocomplete, or internal HR tooling. The response gives you a `data` array of job position objects, plus pagination `meta` and navigation `links` so you can build result lists page by page.

When `include_related` is set to `true`, each job position can also include `related_job_positions`, with related role IDs, names, slugs, and relevancy `weight` values. That makes it useful for suggesting adjacent roles, building role-mapping logic, or grouping similar positions in a talent product.

If you only need the basics, keep the request simple and work from `id`, `name`, and `slug`. If you need relationship data, opt in explicitly and use the returned weights to rank the related positions.

## Usage

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