---
descriptions:
  list_roles:
    data: 'Array of [Environment Roles](/reference/roles/role) in priority order.'
reference:
  curl:
    - key: list_roles
      id: list_roles
      url: /reference/roles/role/list
      title: /authorization/roles
      type: GET
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: array
              description: (list_roles.data)
  js:
    - key: listRoles
      id: list_roles
      url: /reference/roles/role/list
      title: authorization.listRoles()
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: 'Role[]'
              description: (list_roles.data)
  python:
    - key: list_roles
      id: list_roles
      url: /reference/roles/role/list
      title: authorization.list_roles()
      returns:
        - key: anonymous
          type: WorkOSListResource
          unwrap: true
          properties:
            - key: data
              type: 'list[Role]'
              description: (list_roles.data)
originalPath: .tmp-workos-clone/packages/docs/content/reference/roles/role/list.mdx
---

## List environment roles

Get a list of all environment roles. Roles are returned in priority order.

<CodeBlock referenceId="list_roles">
  <CodeBlockTab title="Request" file="list-roles-request" />
  <CodeBlockTab title="Response" file="list-roles-response" />
</CodeBlock>