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

# Get recording AI field

> Retrieve a recording AI field.

Retrieves a recording AI field.


## OpenAPI

````yaml GET /v1/recordings/fields/{fieldId}
openapi: 3.1.0
info:
  title: Claap API
  description: Development documentation
  version: 0.0.0
servers:
  - url: https://api.claap.io/
security:
  - ApiKey: []
paths:
  /v1/recordings/fields/{fieldId}:
    get:
      description: Retrieve a recording AI field.
      operationId: getV1RecordingsAiFieldsByAiFieldId
      parameters:
        - in: path
          name: fieldId
          schema:
            type: string
            description: Recording AI field identifier
          required: true
      responses:
        '200':
          description: Recording AI field was successfully retrieved
          content:
            application/json:
              schema:
                type: object
                properties:
                  result:
                    $ref: '#/components/schemas/AiField'
                required:
                  - result
              example:
                result:
                  fieldId: AiSummarySection#Qh7Kd2Rm9Tz4Vb1Ns6Xa0
                  title: Objections raised
                  kind: Field
                  outputType: List
                  prompt: List the objections raised by the prospect during the call.
                  hasTimecodes: true
                  authorId: Xk2Rd7Mv4Bn9Ts1Lq6Wf3
                  createdAt: '2026-05-14T09:30:00Z'
        '404':
          description: Recording AI field was not found
components:
  schemas:
    AiField:
      type: object
      properties:
        fieldId:
          type: string
          description: >-
            AI field identifier. Matches the `fieldId` of `AiSection` view
            columns.
        title:
          type: string
          description: The field title.
        kind:
          type: string
          enum:
            - Field
            - Global
            - View
          description: >-
            The kind of AI section. Fields managed through the API are always of
            kind `Field`.
        outputType:
          type: string
          enum:
            - ActionList
            - Checkbox
            - Date
            - List
            - MultiSelect
            - Numeric
            - Paragraph
            - Rating
            - RichText
            - Select
          description: The type of value produced by the AI.
        prompt:
          type: string
          description: Instructions describing what the AI should extract.
        coloredSelectOptions:
          type: array
          items:
            $ref: '#/components/schemas/AiFieldSelectOption'
          description: >-
            The options the AI can choose from. Only set for the `Select` and
            `MultiSelect` output types.
        hasTimecodes:
          type: boolean
          description: >-
            Whether list items are linked to the moment of the recording they
            were extracted from. Only set for the `List` output type.
        ratingScale:
          type: integer
          description: The maximum rating. Only set for the `Rating` output type.
        crmField:
          $ref: '#/components/schemas/AiFieldCrmField'
          description: >-
            The CRM property the field is mapped to. Never set for company AI
            fields.
        authorId:
          type: string
          description: Identifier of the user who created the field.
        archivedAt:
          type: string
          format: date-time
          description: When the field was archived. Only set on archived fields.
        createdAt:
          type: string
          format: date-time
          description: When the field was created.
      required:
        - fieldId
        - title
        - kind
        - outputType
        - prompt
        - createdAt
      description: >-
        An AI field: a custom prompt with a typed output, evaluated by AI.
        Usable as an `AiSection` view column through its `fieldId`.
    AiFieldSelectOption:
      type: object
      properties:
        value:
          type: string
          description: The option label, as chosen by the AI and displayed in Claap.
        color:
          type: string
          enum:
            - blue
            - green
            - yellow
            - purple
            - red
            - bordeaux
            - turquoise
          description: The option color in the Claap interface.
      required:
        - value
        - color
      description: An option of a `Select` or `MultiSelect` AI field.
    AiFieldCrmField:
      type: object
      properties:
        entity:
          type: string
          enum:
            - Call
            - Company
            - Contact
            - Deal
            - Lead
            - Meeting
          description: The CRM entity the property belongs to.
        label:
          type: string
          description: The CRM property label.
        name:
          type: string
          description: The CRM property name.
        source:
          type: string
          enum:
            - Attio
            - Hubspot
            - Pipedrive
            - Salesforce
          description: The CRM the property comes from.
        type:
          type: string
          enum:
            - Checkbox
            - Date
            - MultiSelect
            - Numeric
            - RichText
            - Select
            - Text
          description: The CRM property type.
      required:
        - entity
        - label
        - name
        - source
        - type
      description: The CRM property the AI field is mapped to.
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: X-Claap-Key

````