---
descriptions:
  list_permissions:
    data: 'Array of [Permissions](/reference/roles/permission).'
reference:
  curl:
    - key: list_permissions
      id: list_permissions
      url: /reference/roles/permission/list
      title: /authorization/permissions
      type: GET
      parameters:
        - (limit)
        - (before)
        - (after)
        - (order)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: array
              description: (list_permissions.data)
            - key: list_metadata
              type: object
              properties:
                - (before)
                - (after)
  js:
    - key: listPermissions
      id: list_permissions
      url: /reference/roles/permission/list
      title: authorization.listPermissions()
      parameters:
        - key: options
          type: object
          optional: true
          unwrap: true
          properties:
            - (limit)
            - (before)
            - (after)
            - (order)
      returns:
        - key: anonymous
          type: object
          unwrap: true
          properties:
            - key: data
              type: 'Permission[]'
              description: (list_permissions.data)
            - key: listMetadata
              type: object
              properties:
                - (before)
                - (after)
  python:
    - key: list_permissions
      id: list_permissions
      url: /reference/roles/permission/list
      title: authorization.list_permissions()
      parameters:
        - (limit)
        - (before)
        - (after)
        - (order)
      returns:
        - key: anonymous
          type: WorkOSListResource
          unwrap: true
          properties:
            - key: data
              type: 'list[Permission]'
              description: (list_permissions.data)
            - key: list_metadata
              type: ListMetadata
              properties:
                - (before)
                - (after)
originalPath: .tmp-workos-clone/packages/docs/content/reference/roles/permission/list.mdx
---

## List permissions

Get a list of all permissions in your WorkOS environment.

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