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

# List regulatory workflow templates and workspace instances

> Every workflow template (CADOC 5710/5711) with its field schema and the caller workspace instances of it. A workspace may run several instances of one template, one per regulated entity.



## OpenAPI

````yaml /api-reference/platform-api.json get /v2/workflows
openapi: 3.0.0
info:
  title: Range Platform API
  description: >-
    The Range Platform API for workspace management, counterparties, and
    operational tooling.
  version: 1.7.24
  contact: {}
servers:
  - url: https://api.range.org
    description: Range API Server
security:
  - Authorization: []
  - Authorization: []
tags:
  - name: Address Information
    description: Get information about a crypto address.
  - name: Transfer Enrichments
    description: Attach workspace-scoped notes and categories to transfers.
  - name: Counterparties
    description: Manage external entities, their addresses, bank accounts, and documents.
paths:
  /v2/workflows:
    get:
      tags:
        - Workflows
      summary: List regulatory workflow templates and workspace instances
      description: >-
        Every workflow template (CADOC 5710/5711) with its field schema and the
        caller workspace instances of it. A workspace may run several instances
        of one template, one per regulated entity.
      operationId: listWorkflows
      parameters: []
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListWorkflowsResponseDto'
components:
  schemas:
    ListWorkflowsResponseDto:
      type: object
      properties:
        items:
          type: array
          items:
            $ref: '#/components/schemas/WorkflowTemplateDto'
      required:
        - items
    WorkflowTemplateDto:
      type: object
      properties:
        template:
          type: string
          example: cadoc-5711
          enum:
            - cadoc-5710
            - cadoc-5711
        pretty_name:
          type: string
          example: CADOC 5711 - Daily custody filing
        default_cadence:
          type: string
          enum:
            - daily
            - monthly
        allowed_formats:
          type: array
          items:
            type: string
            enum:
              - xml
        field_schema:
          type: object
          additionalProperties: true
          description: Template-declared fields an instance may set.
        instances:
          description: The workspace instances of this template, possibly empty.
          type: array
          items:
            $ref: '#/components/schemas/WorkflowInstanceDto'
      required:
        - template
        - pretty_name
        - default_cadence
        - allowed_formats
        - field_schema
        - instances
    WorkflowInstanceDto:
      type: object
      properties:
        id:
          type: string
          example: 9b2f7c61-2d4e-4a8b-9f10-3c5d7e9a1b2c
        name:
          type: string
          example: CADOC 5711 - Range Brasil Ltda
        email:
          type: string
          example: compliance@example.com
        enabled:
          type: boolean
          example: true
        recipients:
          type: array
          items:
            type: string
        cadence:
          type: string
          enum:
            - daily
            - monthly
        formats:
          type: array
          items:
            type: string
            enum:
              - xml
        report_mode:
          type: string
          enum:
            - always
            - exception_only
        fields:
          type: object
          additionalProperties:
            type: string
          example:
            cnpj: '99999999'
        updated_by:
          type: string
          nullable: true
          example: user@example.com
        created_at:
          type: string
          example: '2026-08-25T00:00:00.000Z'
        updated_at:
          type: string
          example: '2026-08-25T00:00:00.000Z'
      required:
        - id
        - name
        - email
        - enabled
        - recipients
        - cadence
        - formats
        - report_mode
        - fields
        - created_at
        - updated_at
  securitySchemes:
    Authorization:
      type: apiKey
      in: header
      name: X-API-KEY
      description: Authorization method required to allow user to access the api endpoints.

````