> ## 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.

# List Evaluators

> Returns all evaluators for the authenticated account, sorted by creation date (newest first).

<Note>
  Results are not paginated. `data.count` reflects the total number returned (max 20 per account).
</Note>


## OpenAPI

````yaml api-reference/openapi-evaluators.json POST /list-evaluators
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:
  /list-evaluators:
    post:
      summary: List Evaluators
      description: >-
        Returns all evaluators for the authenticated account, sorted by creation
        date (newest first).
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ListEvaluatorsRequest'
            examples:
              ListAll:
                summary: List all evaluators
                value: {}
      responses:
        '200':
          description: Evaluators retrieved successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListEvaluatorsResponse'
              examples:
                Success:
                  summary: Evaluators listed
                  value:
                    data:
                      items:
                        - 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.
                          criteria:
                            - id: 141aceae-9fe2-4e55-80c7-707b0aeb9bff
                              name: Saludo Corporativo
                              description: >-
                                El agente debe presentarse con su nombre
                                completo...
                              type: boolean
                              weight: 50
                            - id: a2b542de-a06a-44ea-9975-20cab95ccaa8
                              name: Verificacion de Identidad
                              description: >-
                                El agente debe verificar la identidad del
                                cliente...
                              type: strict
                              weight: 0
                            - id: 228dc9a9-30a4-447a-9b0e-7ef01904fc2c
                              name: Empatia
                              description: >-
                                El agente muestra comprension ante la situacion
                                del cliente...
                              type: scale
                              weight: 50
                          created_at: '2026-03-21T15:50:25.898670+00:00'
                        - evaluator_id: 2abb5563-dd64-47bb-bb17-94252e168b06
                          tag: pitch temporal
                          description: ''
                          language: es
                          context: >-
                            Estas evaluando un pitch de una empresa a
                            inversores.
                          criteria:
                            - id: 2faa4a20-7445-4beb-a09e-2af26872dba3
                              name: Saludo Corporativo inicial2
                              description: >-
                                El agente debe presentarse con su nombre
                                completo...
                              type: boolean
                              weight: 34
                            - id: 5718a64e-43e6-4959-90a6-19946b44249c
                              name: Escucha Activa
                              description: El agente no interrumpe al cliente...
                              type: scale
                              weight: 33
                            - id: d34172c8-6bf7-486e-aced-d35dc8c2c283
                              name: Manejo de Objeciones
                              description: Ante una objecion o rechazo del cliente...
                              type: scale
                              weight: 33
                            - id: 58f6bc79-3eda-4e67-b762-52466145850a
                              name: cierre de inversion
                              description: >-
                                consigue cerrar la venta/inversion
                                satisfactoriamente
                              type: strict
                              weight: 0
                          created_at: '2026-03-07T22:53:28.735002+00:00'
                      count: 4
components:
  schemas:
    ListEvaluatorsRequest:
      type: object
      description: No parameters required. Send an empty object.
    ListEvaluatorsResponse:
      type: object
      properties:
        data:
          type: object
          properties:
            items:
              type: array
              items:
                $ref: '#/components/schemas/EvaluatorObject'
              description: >-
                Array of evaluator objects sorted by creation date (newest
                first).
            count:
              type: integer
              description: Total number of evaluators returned.
    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

````