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

# List judge evaluations

> List this judge's evaluations, newest first



## OpenAPI

````yaml GET /api/dataframer/judges/{judge_id}/evaluations/
openapi: 3.0.0
info:
  title: DataFramer API
  version: 0.1.0
  description: ''
  termsOfService: https://www.aimon.ai/docs/privacy-policy.pdf
  contact:
    name: DataFramer Support
    email: info@dataframer.ai
  license:
    name: Proprietary
  x-logo:
    url: https://dataframer.ai/logo.png
    altText: DataFramer AI
  x-stainless:
    package-name: aimon-dataframer
    namespace:
      - aimon
      - dataframer
servers:
  - url: https://df-api.dataframer.ai
    description: Production server
security:
  - BearerAuth: []
externalDocs:
  description: Complete API Guide
  url: https://docs.dataframer.ai/dataframer
paths:
  /api/dataframer/judges/{judge_id}/evaluations/:
    get:
      summary: List judge evaluations
      description: List this judge's evaluations, newest first.
      operationId: api_dataframer_judges_evaluations_list
      parameters:
        - name: judge_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 50
            maximum: 200
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            default: 0
      responses:
        '200':
          description: Evaluations for the judge
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/JudgeEvaluation'
                  count:
                    type: integer
      x-codeSamples:
        - lang: Python
          source: |-
            import os
            from dataframer import Dataframer

            client = Dataframer(
                api_key=os.environ.get("DATAFRAMER_API_KEY"),  # This is the default and can be omitted
            )
            evaluations = client.dataframer.judges.evaluations.list(
                judge_id="182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
            )
            print(evaluations.count)
        - lang: cURL
          source: >-
            curl
            https://df-api.dataframer.ai/api/dataframer/judges/$JUDGE_ID/evaluations/
            \
                -H "Authorization: Bearer $DATAFRAMER_API_KEY"
components:
  schemas:
    JudgeEvaluation:
      type: object
      properties:
        id:
          type: string
          format: uuid
        judge_id:
          type: string
          format: uuid
        judge_version:
          type: integer
          nullable: true
          description: Version number of the judge version that graded this content.
        source:
          type: string
          enum:
            - api
            - monitor
            - ui
        status:
          type: string
          enum:
            - succeeded
            - failed
        model:
          type: string
          description: The judge model used.
        verdict:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/JudgeVerdict'
          description: Null when status is `failed`.
        error:
          type: string
          nullable: true
        latency_ms:
          type: integer
          nullable: true
        created_at:
          type: string
          format: date-time
    JudgeVerdict:
      type: object
      properties:
        overall_score:
          type: number
          nullable: true
          description: Mean of the per-dimension normalized scores (0-1).
        confidence:
          type: number
          nullable: true
          description: The judge's self-reported confidence (0-1).
        reasoning:
          type: string
          description: The judge's overall reasoning.
        dimensions:
          type: array
          items:
            $ref: '#/components/schemas/JudgeVerdictDimension'
    JudgeVerdictDimension:
      type: object
      properties:
        dimension_id:
          type: string
          description: Stable machine id of the dimension.
        name:
          type: string
        scoring_model:
          type: string
          enum:
            - pass_fail
            - scale_1_5
            - single_select
            - checklist
        label:
          type: string
          description: Chosen level's label (single-select scoring models).
        labels:
          type: array
          items:
            type: string
          description: Ticked levels' labels (checklist scoring model).
        score:
          type: number
          nullable: true
          description: >-
            Normalized 0-1 score for this dimension — identical normalization to
            the DataFramer UI.
        passed:
          type: boolean
          nullable: true
          description: >-
            For pass_fail dimensions only: whether the content passed. Null for
            other scoring models.
        notes:
          type: string
          description: The judge's note for this dimension.
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: 'API Key authentication. Format: "Bearer YOUR_API_KEY"'

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.