---
title: "List global roles"
method: GET
path: "/admin/integrations/data/global-roles"
tags: ["Admin Integrations"]
---

# List global roles

`GET /admin/integrations/data/global-roles`

Returns paginated global roles at the organization level.
Supports standard Spring pagination parameters.

## Query parameters

- `page` integer
- `size` integer
- `sort` string

## Response `200`

OK

- object
  - `data` object[]
    - `roleSetId` string, uuid — Specifies the unique role set identifier.
    - `roleName` string — Specifies the display name of the role.
    - `description` string — Specifies the role description.
    - `appType` 'BILLING' | 'ZEPHR' | 'REVENUE' | 'EXTENSIBILITY_FRAMEWORK' | 'SSP_ANALYSER' | 'ORDER_ORCHESTRATION' | 'PAYMENTS' | 'COLLECT' | 'CPQ' — Specifies the application type.
    - `entityId` string, uuid, nullable — Specifies the tenant entity ID for the role.
    - `organizationId` string — Specifies the organization ID.
    - `status` 'ENABLED' | 'DISABLED' — Specifies the role status.
    - `roleType` 'DEFAULT' | 'CUSTOM' — Specifies the role type.
    - `sourceType` string — Specifies the source of the role definition.
    - `permissionGroupIds` string[] — Specifies the associated permission group IDs.
    - `globalRoleIds` string[] — Specifies the associated global role IDs.
    - `createdOn` string, date-time — Specifies the creation timestamp.
    - `updatedOn` string, date-time — Specifies the last update timestamp.
    - `createdByUsername` string — Specifies the username of the creator.
  - `page` integer — The zero-based page number of the current page.
  - `size` integer — The number of records returned per page.
  - `totalElements` integer — The total number of matching records.
  - `totalPages` integer — The total number of available pages.
  - `hasNext` boolean — Indicates whether another page of results is available.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zuora/api-reference/revisions/d11e237f3e54/schema)
