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

# Get the fields a workflow's conditions can read

> List the fields a conditional path on this workflow can be written against, with the comparisons each one accepts and how both read in the Cal.com app. The catalog comes from what the workflow is active on — booking questions on its active event types — so it also reports the entities that do not ask for a field. Not available to third-party OAuth access tokens.



## OpenAPI

````yaml /api-reference/v2/openapi.json get /v2/workflows/{workflowId}/condition-fields
openapi: 3.0.0
info:
  title: Cal.com API v2
  description: ''
  version: 1.0.0
  contact: {}
servers: []
security: []
tags: []
paths:
  /v2/workflows/{workflowId}/condition-fields:
    get:
      tags:
        - Workflows
      summary: Get the fields a workflow's conditions can read
      description: >-
        List the fields a conditional path on this workflow can be written
        against, with the comparisons each one accepts and how both read in the
        Cal.com app. The catalog comes from what the workflow is active on —
        booking questions on its active event types — so it also reports the
        entities that do not ask for a field. Not available to third-party OAuth
        access tokens.
      operationId: UserWorkflowsController_2026_09_22_getWorkflowConditionFields
      parameters:
        - name: cal-api-version
          in: header
          description: >-
            Must be set to 2026-09-22 to use this version of the workflow
            endpoints.
          required: true
          schema:
            type: string
            example: '2026-09-22'
        - name: Authorization
          in: header
          description: >-
            value must be `Bearer <token>` where `<token>` is api key prefixed
            with cal_, managed user access token, or OAuth access token
          required: true
          schema:
            type: string
        - name: workflowId
          required: true
          in: path
          schema:
            type: number
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WorkflowConditionFieldsOutput'
components:
  schemas:
    WorkflowConditionFieldsOutput:
      type: object
      properties:
        status:
          type: string
          enum:
            - success
          example: success
        data:
          $ref: '#/components/schemas/WorkflowConditionFieldsDataOutputDto'
      required:
        - status
        - data
    WorkflowConditionFieldsDataOutputDto:
      type: object
      properties:
        truncated:
          type: boolean
          description: >-
            True when the catalog samples the first 100 active entities.
            Warnings cover only that sample.
        fields:
          description: The fields a condition on this workflow can read
          type: array
          items:
            $ref: '#/components/schemas/WorkflowConditionFieldOutputDto'
        activeOn:
          description: >-
            The event types the catalog was built from — what the workflow is
            active on, capped at 100.
          example:
            - Intro call
            - Demo
          type: array
          items:
            type: string
        isActiveOnAll:
          type: boolean
          description: >-
            Present when the workflow is active on everything its owner has, in
            which case `activeOn` lists what the cap allowed.
          example: true
      required:
        - truncated
        - fields
        - activeOn
    WorkflowConditionFieldOutputDto:
      type: object
      properties:
        id:
          type: string
          description: The value to send as a condition's `field`
          example: company-size
        label:
          type: string
          description: How the field reads in the editor
          example: Company size
        type:
          type: string
          description: >-
            What kind of answer the field holds, which decides the operators it
            accepts
          example: select
        operators:
          description: The comparisons this field accepts
          type: array
          items:
            $ref: '#/components/schemas/WorkflowConditionOperatorOutputDto'
        options:
          description: >-
            The values this field can hold, for select and multiselect fields.
            Empty for the rest.
          type: array
          items:
            $ref: '#/components/schemas/WorkflowConditionFieldOptionOutputDto'
        missingFrom:
          description: >-
            Names of the event types this workflow is active on that do not ask
            for this field. A condition on it is scored false for them, so the
            branch never runs for those triggers.
          example:
            - Intro call
          type: array
          items:
            type: string
        hasTypeConflict:
          type: boolean
          description: >-
            Whether the entities this workflow is active on disagree about the
            field's type. The operators listed are those of the first
            definition, and a condition may behave differently per trigger.
          example: false
      required:
        - id
        - label
        - type
        - operators
        - options
        - missingFrom
        - hasTypeConflict
    WorkflowConditionOperatorOutputDto:
      type: object
      properties:
        id:
          type: string
          description: The value to send as a condition's `operator`
          example: select_equals
        label:
          type: string
          description: >-
            How the comparison reads in the editor. Ids differ by field type
            where the label does not — `equal` on a text field and
            `select_equals` on a select both read "Equals" — so render this
            rather than the id.
          example: Equals
      required:
        - id
        - label
    WorkflowConditionFieldOptionOutputDto:
      type: object
      properties:
        value:
          type: string
          description: The value a condition compares against
          example: enterprise
        label:
          type: string
          description: How the option reads in the editor
          example: Enterprise
      required:
        - value
        - label

````