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

> List the workspace's judges with their latest ready version

A judge grades content against a rubric you build in the app — see [Judges](/docs/judges/overview).


## OpenAPI

````yaml GET /api/dataframer/judges/
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/:
    get:
      summary: List judges
      description: >-
        List the workspace's judges with each judge's latest ready version and
        its rubric dimension summary. Use a judge's `id` with the evaluations
        endpoints.
      operationId: api_dataframer_judges_list
      parameters:
        - name: project_id
          in: query
          required: false
          schema:
            type: string
          description: Only judges belonging to this project.
        - 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: Judges for the workspace
          content:
            application/json:
              schema:
                type: object
                properties:
                  results:
                    type: array
                    items:
                      $ref: '#/components/schemas/Judge'
                  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
            )
            judges = client.dataframer.judges.list()
            print(judges.count)
        - lang: cURL
          source: |-
            curl https://df-api.dataframer.ai/api/dataframer/judges/ \
                -H "Authorization: Bearer $DATAFRAMER_API_KEY"
components:
  schemas:
    Judge:
      type: object
      properties:
        id:
          type: string
          format: uuid
        name:
          type: string
        description:
          type: string
        project_id:
          type: string
          format: uuid
        created_at:
          type: string
          format: date-time
        latest_version:
          type: object
          nullable: true
          description: >-
            The judge's latest ready version — the one evaluations run on. Null
            while the first prompt is still generating.
          properties:
            version_number:
              type: integer
            model:
              type: string
              description: The judge's configured default model.
            created_at:
              type: string
              format: date-time
            dimensions:
              type: array
              items:
                $ref: '#/components/schemas/JudgeDimensionSummary'
    JudgeDimensionSummary:
      type: object
      properties:
        dimension_id:
          type: string
          description: Stable machine id of the rubric dimension (survives renames).
        name:
          type: string
        scoring_model:
          type: string
          enum:
            - pass_fail
            - scale_1_5
            - single_select
            - checklist
        required:
          type: boolean
          description: Whether the judge is obligated to grade 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.