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

# List monitor judgments

> Read the monitor’s judged traces and corrected series.



## OpenAPI

````yaml https://api.uselemma.ai/openapi.json get /monitors/{monitor_id}/judgments
openapi: 3.1.0
info:
  title: Lemma Platform API
  description: Lemma Platform HTTP API for AI observability and workspace operations.
  version: 0.1.0
servers:
  - url: https://api.uselemma.ai
    description: Lemma production API
security:
  - bearerAuth: []
paths:
  /monitors/{monitor_id}/judgments:
    get:
      tags:
        - Monitors / Judgments
      summary: List monitor judgments
      description: Read the monitor’s judged traces and corrected series.
      operationId: list_monitor_judgments
      parameters:
        - name: monitor_id
          in: path
          required: true
          description: Monitor ID.
          schema:
            type: string
        - name: start_inclusive
          in: query
          required: true
          description: Window start, inclusive.
          schema:
            type: string
        - name: end_exclusive
          in: query
          required: true
          description: Window end, exclusive. Must be after start_inclusive.
          schema:
            type: string
        - name: granularity
          in: query
          required: false
          description: Series bucket size.
          schema:
            type: string
            enum:
              - day
              - week
              - month
        - name: fit
          in: query
          required: false
          description: true keeps fits, false keeps misses, omit for both.
          schema:
            type: boolean
        - name: limit
          in: query
          required: false
          description: Page size, from 1 to 100. Default 25.
          schema:
            type: integer
            minimum: 1
            maximum: 100
        - name: cursor
          in: query
          required: false
          description: Opaque continuation from next_request. Omit it on the first call.
          schema:
            type: string
      responses:
        '200':
          description: Window series and judged traces
          content:
            application/json:
              schema:
                type: object
                properties:
                  series:
                    type: array
                    items:
                      type: object
                      properties:
                        bucket:
                          type: string
                        traces_seen:
                          type: integer
                          minimum: 0
                        fit_count:
                          type: integer
                          minimum: 0
                        occurrence_count:
                          type: integer
                          minimum: 0
                        rate:
                          type:
                            - number
                            - 'null'
                      required:
                        - bucket
                        - traces_seen
                        - fit_count
                        - occurrence_count
                        - rate
                      additionalProperties: false
                  judgments:
                    type: array
                    items:
                      type: object
                      properties:
                        trace_id:
                          type: string
                          format: uuid
                        timestamp:
                          type: string
                          format: date-time
                        fit:
                          type: boolean
                        correction:
                          type:
                            - object
                            - 'null'
                          properties:
                            id:
                              type: string
                              format: uuid
                            verdict:
                              type: string
                              enum:
                                - exclude
                                - include
                            reason:
                              type:
                                - string
                                - 'null'
                            active:
                              type: boolean
                          required:
                            - id
                            - verdict
                            - reason
                            - active
                          additionalProperties: false
                      required:
                        - trace_id
                        - timestamp
                        - fit
                        - correction
                      additionalProperties: false
                  next_request:
                    type:
                      - object
                      - 'null'
                    properties:
                      operation:
                        type: string
                        minLength: 1
                      arguments:
                        type: object
                        properties:
                          monitor_id:
                            type: string
                            format: uuid
                          start_inclusive:
                            type: string
                            format: date-time
                          end_exclusive:
                            type: string
                            format: date-time
                          granularity:
                            type: string
                            enum:
                              - day
                              - week
                              - month
                            default: day
                          fit:
                            anyOf:
                              - type: boolean
                              - type: string
                                enum:
                                  - 'true'
                                  - 'false'
                          limit:
                            type: integer
                            minimum: 1
                            maximum: 100
                            default: 25
                          cursor:
                            type: string
                            minLength: 1
                            maxLength: 16384
                        additionalProperties: false
                    required:
                      - operation
                      - arguments
                    additionalProperties: false
                required:
                  - series
                  - judgments
                  - next_request
                additionalProperties: false
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                  retryable:
                    type: boolean
                  retry_after_seconds:
                    type: number
                    minimum: 0
                required:
                  - detail
                  - code
                  - retryable
                additionalProperties: false
        '401':
          description: Unauthenticated
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                required:
                  - detail
                additionalProperties: false
        '404':
          description: Not found
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                  retryable:
                    type: boolean
                  retry_after_seconds:
                    type: number
                    minimum: 0
                required:
                  - detail
                  - code
                  - retryable
                additionalProperties: false
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  detail:
                    type: string
                  code:
                    type: string
                  retryable:
                    type: boolean
                  retry_after_seconds:
                    type: number
                    minimum: 0
                required:
                  - detail
                  - code
                  - retryable
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

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