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

# Get Evaluator

> Retrieve a single evaluator by ID.

<Note>
  Returns `404` if the evaluator is not found.
</Note>

<Note>
  For the full Evaluator data model and criteria types, see [Evaluator](/core/evaluator).
</Note>


## OpenAPI

````yaml api-reference/openapi-evaluators.json POST /get-evaluator
openapi: 3.1.0
info:
  title: Heify API — Evaluators
  description: Endpoints for creating, retrieving, and managing Evaluators.
  version: 1.0.0
servers:
  - url: https://api.heify.com
security:
  - apiKeyAuth: []
paths:
  /get-evaluator:
    post:
      summary: Get Evaluator
      description: Retrieves a single evaluator by ID.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetEvaluatorRequest'
            examples:
              GetEvaluator:
                summary: Get an evaluator
                value:
                  evaluator_id: cd9e6ef7-fd3c-4cf1-9dd5-a5d5dbc8e887
      responses:
        '200':
          description: Evaluator retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetEvaluatorResponse'
              examples:
                Success:
                  summary: Evaluator retrieved
                  value:
                    data:
                      evaluator_id: cd9e6ef7-fd3c-4cf1-9dd5-a5d5dbc8e887
                      tag: nombree
                      description: descripcion
                      language: ar
                      context: >-
                        Estas evaluando a un agente de atencion al cliente en
                        una llamada entrante. El agente representa a la empresa
                        y debe resolver la consulta del cliente siguiendo los
                        protocolos internos.
                      criteria:
                        - id: 141aceae-9fe2-4e55-80c7-707b0aeb9bff
                          name: Saludo Corporativo
                          description: >-
                            El agente debe presentarse con su nombre completo,
                            indicar el nombre de la empresa y dar la bienvenida
                            al cliente.
                          type: boolean
                          weight: 50
                        - id: a2b542de-a06a-44ea-9975-20cab95ccaa8
                          name: Verificacion de Identidad
                          description: >-
                            El agente debe verificar la identidad del cliente
                            solicitando al menos dos datos personales antes de
                            proporcionar informacion sensible.
                          type: strict
                          weight: 0
                        - id: 228dc9a9-30a4-447a-9b0e-7ef01904fc2c
                          name: Empatia
                          description: >-
                            El agente muestra comprension ante la situacion del
                            cliente utilizando frases de reconocimiento.
                          type: scale
                          weight: 50
                      created_at: '2026-03-21T15:50:25.898670+00:00'
components:
  schemas:
    GetEvaluatorRequest:
      type: object
      properties:
        evaluator_id:
          type: string
          format: uuid
          description: The unique identifier of the evaluator to retrieve.
      required:
        - evaluator_id
    GetEvaluatorResponse:
      type: object
      properties:
        data:
          $ref: '#/components/schemas/EvaluatorObject'
    EvaluatorObject:
      type: object
      description: Full evaluator object as returned by the API.
      properties:
        evaluator_id:
          type: string
          format: uuid
          description: Unique identifier for this evaluator.
        tag:
          type: string
          description: Name/label for the evaluator (e.g. campaign name).
        description:
          type: string
          nullable: true
          description: Description of the evaluator's purpose.
        language:
          type: string
          description: >-
            Language used for AI evaluation output. `"df"` = auto-detect from
            audio.
        context:
          type: string
          nullable: true
          description: Additional context provided to the AI during evaluation.
        criteria:
          type: array
          items:
            $ref: '#/components/schemas/CriterionObject'
          description: Evaluation criteria for this evaluator.
        created_at:
          type: string
          description: Creation timestamp (ISO 8601).
    CriterionObject:
      type: object
      description: >-
        A criterion as returned in API responses. Identical to the input shape
        but includes an auto-generated `id`.
      properties:
        id:
          type: string
          format: uuid
          description: Auto-generated unique identifier for this criterion.
        name:
          type: string
          description: Name of the criterion.
        description:
          type: string
          description: Evaluation instructions provided to the AI.
        type:
          type: string
          enum:
            - boolean
            - scale
            - strict
          description: Criterion evaluation type.
        weight:
          type: integer
          description: Weight in the final score. Always `0` for `strict` criteria.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````