Skip to main content
GET
List users

Authorizations

Authorization
string
header
required

API key for authentication. Make sure to include the word apikey, followed by a single space and then your token. Example: apikey 1234_abcdef

Query Parameters

ids
integer[]

Filter by user id. Repeat the parameter for several values (OR), e.g. ids=1&ids=2.

email
object

Filter by email, case-insensitive. Bracket operator required: email[exact], email[prefix], email[contains] or email[suffix], e.g. email[contains]=example.com.

name
object

Filter by name, case-insensitive. Bracket operator required: name[exact], name[prefix], name[contains] or name[suffix], e.g. name[prefix]=Jo.

created_at
object

Filter by creation time. Bracket operator required: created_at[gte], created_at[gt], created_at[lt] or created_at[lte] (ISO 8601), e.g. created_at[gte]=2026-01-01T00:00:00Z&created_at[lt]=2026-02-01T00:00:00Z.

langs
enum<string>[]

Filter by interface language. Repeat the parameter for several values (OR), e.g. langs=en&langs=ru.

Available options:
az,
de,
en,
ru,
zh
auth_type
enum<string>

Filter by login method - a specific social provider, 'sso', or 'password'.

Available options:
password,
sso,
google-oauth2,
github
order_by
string

Sort order as field.direction, e.g. order_by=created_at.desc. Allowed fields: created_at, email, name. Defaults to created_at.desc.

limit
integer

The maximum number of items.

offset
integer

Offset relative to the beginning of list.

Response

OK.

count
integer
required
Example:

123

results
object[]
required
next
string<uri> | null
Example:

"https://api.gcore.com/iam/v2/users?offset=400&limit=100"

previous
string<uri> | null
Example:

"https://api.gcore.com/iam/v2/users?offset=200&limit=100"