API Reference

List positions with filtering and pagination

get
https://api.gupy.io/os/v1/positions

Retrieves a paginated list of positions with optional filtering by name, status, area, role, parent position, and other criteria. Supports both UUID-based and name/code-based filtering.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string

Position name to filter

string

Position external code to filter

string
enum

Position status to filter

Allowed:
uuid

Area UUID to filter

uuid

Role UUID to filter

uuid

Parent position UUID to filter

string

Area name to filter (exact match)

string

Area external code to filter (exact match)

string

Role name to filter (exact match)

string

Role external code to filter (exact match)

string

Parent position name to filter (exact match)

string

Parent position external code to filter (exact match)

number
≥ 1
Defaults to 1

Page number for pagination

number
1 to 100
Defaults to 10

Maximum page size for pagination

Responses

Updated 2 months ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 2 months ago

Did this page help you?