Skip to main content
GET
List role groups

Authorizations

Api-Token
string
header
required

Server-to-server authentication. Generate a token in the admin UI at Settings → Developers → API Access. Send the raw token in the Api-Token header — there is no Bearer prefix.

Tokens can be marked read-only at creation time, in which case the API rejects any non-GET request with 403 Forbidden.

Query Parameters

page
integer
default:1

The collection page number

itemsPerPage
integer
default:100

The number of items per page

Required range: 0 <= x <= 100
pagination
boolean

Enable or disable pagination

gender
string
gender[]
string[]
minAge
integer
minAge[]
integer[]
maxAge
integer
maxAge[]
integer[]
status
string
status[]
string[]
isRoleGroup
boolean
isRoleGroup[]
boolean[]
parent
string
parent[]
string[]
localCenter
string
localCenter[]
string[]
unitType
string
unitType[]
string[]
order[name]
enum<string>
default:asc
Available options:
asc,
desc
order[parent.name]
enum<string>
default:asc
Available options:
asc,
desc
order[userType.position]
enum<string>
default:asc
Available options:
asc,
desc
exists[isRoleGroup]
boolean
exists[localCenter]
boolean
exists[unitType]
boolean
exists[parent]
boolean

Response

200 - application/json

RoleGroup collection

gender
string | null
minAge
integer | null
maxAge
integer | null
onlyFullMember
boolean | null
region
string<iri-reference> | null
Example:

"/api/v1/regions/1"

id
integer
read-only
name
string
logo
string | null
unitType
string<iri-reference> | null
Example:

"/api/v1/unit_types/1"

status
string | null
isRoleGroup
boolean | null
activeMemberCount
integer
emoji
string | null