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

# Search custom field using name



## OpenAPI

````yaml get /v1/custom-field/search
openapi: 3.0.0
info:
  title: Thena Platform
  description: The Thena Platform API description
  version: 1.0.0
  contact: {}
servers:
  - url: https://platform.thena.ai
    description: Platform
  - url: http://localhost:8000
    description: Local
security:
  - ApiKey: []
tags: []
paths:
  /v1/custom-field/search:
    get:
      tags:
        - Custom fields
      description: >-
        This endpoint is only available for standard and enterprise tier
        organizations.
      parameters:
        - name: term
          required: true
          in: query
          description: Search term to find custom fields by name
          schema:
            example: priority
            type: string
        - name: teamId
          required: false
          in: query
          description: Filter by specific team ID
          schema:
            example: team_01jb4xm9qr3kv5w8n2p7s9t1
            type: string
        - name: onlyTeamFields
          required: false
          in: query
          description: Show only team-specific fields
          schema:
            example: false
            type: boolean
      responses:
        '200':
          description: Operation successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetAllCustomFieldsResponse'
        '400':
          description: >-
            Bad Request - No search term provided or user is not a member of the
            team
          content:
            application/json:
              example:
                message: No search term provided
                statusCode: 400
                timestamp: '2024-01-15T10:30:00Z'
        '401':
          description: User is not authenticated!
        '403':
          description: User does not have access to this resource!
        '404':
          description: Resource not found!
        '429':
          description: Too many requests!
        '500':
          description: Something went wrong!
        '503':
          description: This service/resource is currently unavailable.
components:
  schemas:
    GetAllCustomFieldsResponse:
      type: object
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/CustomFieldData'
        status:
          type: boolean
        message:
          type: string
        timestamp:
          format: date-time
          type: string
      required:
        - data
        - status
        - message
        - timestamp
    CustomFieldData:
      type: object
      properties:
        name:
          type: string
        uid:
          type: string
        slug:
          type: string
        organizationId:
          type: string
        source:
          type: string
          enum:
            - ticket
            - account
            - custom_object
            - customer_contact
        fieldType:
          type: string
          enum:
            - single_line
            - multi_line
            - rich_text
            - integer
            - decimal
            - currency
            - date
            - date_time
            - time
            - single_choice
            - multi_choice
            - radio_button
            - checkbox
            - email
            - phone_number
            - url
            - ip_address
            - regex
            - password
            - file_upload
            - calculated
            - lookup
            - address
            - coordinates
            - rating
            - toggle
            - boolean
        options:
          nullable: true
          type: array
          items:
            type: string
        metadata:
          type: object
          nullable: true
        createdAt:
          format: date-time
          type: string
        updatedAt:
          format: date-time
          type: string
        isActive:
          type: boolean
        teamId:
          type: string
        autoAddToAllForms:
          type: boolean
        hintText:
          type: string
        placeholderText:
          type: string
        mandatoryOnCreation:
          type: boolean
        mandatoryOnClose:
          type: boolean
        visibleToCustomer:
          type: boolean
        editableByCustomer:
          type: boolean
        defaultValue:
          type: string
      required:
        - name
        - uid
        - slug
        - organizationId
        - source
        - fieldType
        - options
        - metadata
        - createdAt
        - updatedAt
        - isActive
        - teamId
        - autoAddToAllForms
        - hintText
        - placeholderText
        - mandatoryOnCreation
        - mandatoryOnClose
        - visibleToCustomer
        - editableByCustomer
        - defaultValue
  securitySchemes:
    ApiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: 'Enter your API key '

````