List global users as a platform administrator.

GET

/v1/users

const url = 'https://api.dev.iot-sens.schlossers.at/v1/users?status=active&limit=25';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.dev.iot-sens.schlossers.at/v1/users?status=active&limit=25' \
  --header 'Authorization: Bearer <token>'

Returns an exact count for the same authorization scope and filters as the page. Rows use stable ascending (createdAt, userId) order. Cursors are bound to the actor, authorization scope, filters, and page size.

Authorizations

AccessToken

Parameters

Query Parameters

status

string

Allowed values: active disabled

string

<= 100 characters

cursor

string

<= 512 characters

Opaque continuation token; reuse the original filters and scope.

limit

integer

default: 25

Allowed values: 25 50 100

Responses

200

Stable global-user cursor page.

application/json

object

items

required

Array<object>

object

userId

required

string format: uuid

username

required

One of:

string
null

string

email

required

string format: email

displayName

required

string

>= 1 characters <= 200 characters

status

required

string

Allowed values: active disabled

metadata

required

object

<= 50 properties

key

additional properties

One of:

string

platformRoles

required

Array<string>

Allowed values: platform_admin

isProtected

required

boolean

createdAt

required

string format: date-time

updatedAt

required

string format: date-time

nextCursor

string

totalCount

required

integer

Example

{
  "items": [
    {
      "status": "active",
      "platformRoles": [
        "platform_admin"
      ]
    }
  ]
}

default

A safe platform error response.

application/json

object

error

required

object

code

required

string

Allowed values: VALIDATION_FAILED AUTHENTICATION_FAILED AUTHORIZATION_FAILED RESOURCE_NOT_FOUND CONFLICT DEPENDENCY_FAILURE FLOW_FAILURE RATE_LIMITED INTERNAL_ERROR

category

required

string

Allowed values: validation authentication authorization not_found conflict dependency_failure flow_failure rate_limit internal

message

required

Safe client-facing diagnostic message.

string

correlationId

required

Correlation ID for operational investigation.

string

>= 1 characters

details

Safe bounded diagnostic details.

object

key

additional properties

One of:

string

Example

{
  "error": {
    "code": "VALIDATION_FAILED",
    "category": "validation"
  }
}

Headers

Cache-Control

string

Allowed value: no-store