---
title: "GET /admin/v1/roles"
method: GET
path: "/admin/v1/roles"
tags: ["Roles"]
---

# GET /admin/v1/roles

`GET /admin/v1/roles`

Lists all roles

## Query parameters

- `role` string[]
- `limit` integer
- `cursor` string

## Response `200`

The roles that match the filters provided

- RoleList — A `User` collection.
  - `items` Role[]
    - `name` string, identifier — The name used to identify the role
    - `group_name` string, identifier — The logical administrative group of which this role is part
    - `role_type` 'admin' | 'other' — The role's specific type
    - `data-views` object[]
      - `data-view` string — The name of the data view
    - `display_order` integer
    - `permissions` object
      - `administrative` object[]
        - `permission` 'Access Crowdicity' | 'Access Journey Analytics' | 'Access Strikedeck' | 'Admin Access Crowdicity' | 'Admin Access Journey Analytics' | 'Admin Access Strikedeck' | 'Advanced Digital Survey Management' | 'Blog Contributor' | 'Blog Editor' | 'Blog User' | 'Create Ad Hoc Surveys' | 'Create Ask Now Tests and View My Reports' | 'Create Designs' | 'Create Experience Programs' | 'Create Survey Emails' | 'Create Surveys' | 'Customer Admin Access LivingLens' | 'Digital Command Center Administration' | 'Edit Ad Hoc Survey Sampling Settings' | 'Edit Ad Hoc Surveys' | 'Edit Designs' | 'Edit Experience Programs' | 'Edit Others' Ask Now Tests and View Their Reports' | 'Edit Survey emails' | 'Edit Surveys' | 'Edit Unit Groups' | 'Edit Units' | 'Impersonate Users' | 'Import Data Via Webfeed' | 'Import Users' | 'Manage Ad Hoc Invites' | 'Manage Alert Cases' | 'Manage All Fields' | 'Manage All Translations' | 'Manage Bulk Imports' | 'Manage Conversations' | 'Manage Custom Modules' | 'Manage Data Exports' | 'Manage Data Views' | 'Manage Digital Surveys' | 'Manage Email Allow-lists' | 'Manage Emails Translations' | 'Manage Language Settings' | 'Manage Outbound Change Sets' | 'Manage Reports and Controls' | 'Manage Reports and Controls -- LEGACY' | 'Manage Role Preferences' | 'Manage Roles' | 'Manage Sandboxes' | 'Manage Shared Custom Filters' | 'Manage Shared Survey Text Translations' | 'Manage Surveys' | 'Manage Surveys Translations' | 'Manage Topics' | 'Manage Unit Groups' | 'Manage Unit Types' | 'Manage Units' | 'Manage Users' | 'Manage Zingle Analytics' | 'Manage Zingle Bulk Messaging' | 'Manage Zingle Contact Deletion' | 'Manage Zingle Standard' | 'Manage Zingle User Management' | 'Pro Access LivingLens' | 'Pro Admin Access LivingLens' | 'Remote API Call Configuration Management' | 'Standard Access LivingLens' | 'View Data from MQL' | 'View Data from QueryAPI' | 'View Feedfile Detailed Reports' | 'View Goals' | 'View Installed Apps' | 'View Others' Ask Now Tests and Reports' | 'View Surveys' | 'View feedbacks and reports' | 'Zingle Dashboard Administration' — See [Administrative Permissions](https://docs.medallia.com/admin/index.html#Help/RolesAndPermissions/Administrative_permissions.html) for details.
      - `reporting` object[]
        - `permission` 'Access Mobile App' | 'Access Voices' | 'Add Attachments on Followup Email' | 'Add Notes to Activity Log' | 'Aggregated Actions filters in Responses' | 'All Modules' | 'Allow User-level Filters' | 'Assign Alerts' | 'Attention Types filters in Responses' | 'Batch PDF' | 'Call Customers' | 'Call Status' | 'Change Alert Type' | 'Close/Reopen Alerts' | 'Comment Filter in Other Reports' | 'Comment Filter in Responses' | 'Complex Query' | 'Create Action Plans' | 'Create Case' | 'Create filtered Contact Lists' | 'Custom Exports' | 'Custom Filter' | 'Custom Groups' | 'Custom Query' | 'Customer Effort filters in Responses' | 'Customer List' | 'Customize Suggested Actions Display' | 'Delete Action Plans' | 'Desktop Promotional Banner' | 'Desktop Promotional Page' | 'Disable Custom Timeperiods Option' | 'Disable Saved Filters' | 'Edit Comment Topics' | 'Edit Email Notification Settings' | 'Edit Machine Translation' | 'Edit Manual Translation' | 'Edit sentiment' | 'Employee Recognition filters in Responses' | 'Exclude Social Responses' | 'Exclude Surveys' | 'Export Invitations' | 'Export Ranker, All Questions (Visible Rows)' | 'Export Ranker, All Rows (Visible Columns)' | 'Export Responses' | 'Export Tag Results' | 'Extended Benchmark' | 'External Response Settings' | 'Feedback Type Filter' | 'Followup Options' | 'Forward Response using Enterprise Email' | 'Forward Response via Email' | 'Forward Response via Email through Medallia' | 'Forward Response via Email with PDF' | 'Limited Extended Benchmark' | 'MM2 Add Note (if enabled in Express)' | 'MM2 Assign Alert (if enabled in Express)' | 'MM2 Case Management (if enabled in Express)' | 'MM2 Close Alert (if enabled in Express)' | 'MM2 Manage Alerts (if enabled in Express)' | 'MM2 Ranker Module' | 'MM2 Reopen Alert (if enabled in Express)' | 'MM2 Reply by Email (if enabled in Express)' | 'MM2 Reply by Email With Templates (if enabled in Express)' | 'MM2 Reply by Email Without Templates' | 'MM2 Resolve Alert (if enabled in Express)' | 'MM2 Scorecards Module' | 'MM2 Social Media Reply (If enabled in Express with SOCIAL_MEDIA...)' | 'Manage Action Plan Impact Analysis' | 'Manage Action Plan Tasks' | 'Manage Custom Filters' | 'Manage Custom Rival Lists' | 'Manage Watchlist' | 'Manual Survey Link' | 'Media Type filter in Responses' | 'Mention Units in Comments' | 'Mention Users in Comments' | 'Needs Attention filters in Responses' | 'Opt Out Addressee' | 'Problems Compare' | 'Problems Snapshot' | 'Problems Table' | 'Profiler Graph' | 'Profiler Table' | 'Receive Push Reports built in classic setup' | 'Report Issues with Sources' | 'Resend Invite' | 'Resolve Alerts' | 'Respond Directly' | 'Respond Directly to Social Feedback' | 'Search Field' | 'Select Base Reporting Date' | 'Select Default Filter Settings' | 'Send Followup Email' | 'Send Followup Email with Data Masking (only compatible with MAX)' | 'Send Invitations' | 'Subscriptions' | 'Suggest Involved Users' | 'Suggestion filter in Responses' | 'Topic Filter in Other Reports' | 'Topic Filters in Responses' | 'Update Action Plans' | 'Update Action Plans status' | 'User Activities' | 'View Action Plans' | 'View Activity Log' | 'View Alerts' | 'View Bubbles Topic Investigator' | 'View Charts Topic Investigator' | 'View Comment Keywords' | 'View Comment Topics' | 'View Enhanced responses' | 'View Excluded Surveys' | 'View Personal Data' | 'View Rival Comparision Report' | 'View Rival Responses Report' | 'View Tag Investigator (TI1)' | 'View Theme Explorer' | 'View and Create Community Comments' | 'View and Use Community Likes' | 'Viewed by Others' | 'Wipe Survey Answers' | '[NOT IN USE, REPLACED BY MANAGE_WATCHLIST] Watchlist Notification Creation (Web & Mobile)' — See [Reporting Permissions](https://docs.medallia.com/admin/index.html#Help/RolesAndPermissions/Reporting_permissions.html)
    - `_system_properties` object
      - `created_on` string, date-time — The timestamp when the role was last modified, in ISO-8601 format `yyyy-MM-dd'T'HH:mm:ss.SSSZZ`
      - `modified_on` string, date-time — The timestamp when the role was last modified, in ISO-8601 format `yyyy-MM-dd'T'HH:mm:ss.SSSZZ`
  - `_has_more_items` boolean
  - `_next` object
    - `href` string — Link to the next page in the result set

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Object not found
- `412` — Precondition failed
- `500` — Internal server error

---

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