> ## Documentation Index
> Fetch the complete documentation index at: https://docs.corebanq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List roles

> Get all roles



## OpenAPI

````yaml get /v1/roles
openapi: 3.0.0
info:
  title: Roles API
  version: 1.0.0
  description: API for role-based access control (RBAC)
servers: []
security:
  - bearerAuth: []
tags:
  - name: Roles
    description: Role management operations
  - name: User Roles
    description: User-role management operations
paths:
  /v1/roles:
    get:
      tags:
        - Roles
      summary: List roles
      description: Get all roles
      responses:
        '200':
          description: List of roles
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Role'
components:
  schemas:
    Role:
      type: object
      required:
        - id
        - name
        - active
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        description:
          type: string
        active:
          type: boolean
        system:
          type: boolean
        created_at:
          type: string
          format: date-time
        updated_at:
          type: string
          format: date-time

````