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

# List trace scores

> The scores recorded on one trace, newest first — what `POST /v1/score-trace` produced plus any live scorer attached to the agent. Poll it after scoring: a score appears here once the scorer has run. Narrow with `scorerId` (the id `POST /v1/score-trace` returned) or `spanId`. Only traces of your organization are served; any other trace id is a 404.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/traces/{traceId}/scores
openapi: 3.1.0
info:
  title: Sidenet API
  version: 1.0.0
  description: >-
    Sidenet HTTP endpoints exposed by the Sidenet Studio. All routes require an
    api key that can be generated through the studio in studio.sidenet.ai.
servers:
  - url: https://api.sidenet.ai
security:
  - bearerAuth: []
paths:
  /v1/traces/{traceId}/scores:
    get:
      tags:
        - Experiments
      summary: List trace scores
      description: >-
        The scores recorded on one trace, newest first — what `POST
        /v1/score-trace` produced plus any live scorer attached to the agent.
        Poll it after scoring: a score appears here once the scorer has run.
        Narrow with `scorerId` (the id `POST /v1/score-trace` returned) or
        `spanId`. Only traces of your organization are served; any other trace
        id is a 404.
      parameters:
        - name: traceId
          in: path
          required: true
          schema:
            type: string
            example: 0af7651916cd43dd8448eb211c80319c
          description: >-
            The trace, as shown on the Studio traces page or sent to POST
            /v1/score-trace.
        - name: scorerId
          in: query
          required: false
          schema:
            type: string
            example: completeness-scorer
          description: Only scores from this scorer.
        - name: spanId
          in: query
          required: false
          schema:
            type: string
            example: b7ad6b7169203331
          description: Only scores on this span.
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 0
            default: 0
          description: 0-based page.
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            default: 50
            maximum: 500
      responses:
        '200':
          description: The scores of the trace
          content:
            application/json:
              schema:
                type: object
                properties:
                  traceId:
                    type: string
                  scores:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        scorerId:
                          type: string
                          description: >-
                            The scorer that produced it — the `scorerId` POST
                            /v1/score-trace returned.
                        scorerName:
                          type: string
                          nullable: true
                        spanId:
                          type: string
                          nullable: true
                          description: >-
                            The span that was scored; the root span for a
                            whole-trace score.
                        score:
                          type: number
                        reason:
                          type: string
                          nullable: true
                          description: The scorer's explanation, when it gives one.
                        source:
                          type: string
                          enum:
                            - LIVE
                            - TEST
                          description: >-
                            `LIVE` for a scorer attached to the agent at run
                            time, `TEST` for on-demand scoring.
                        threadId:
                          type: string
                          nullable: true
                        createdAt:
                          type: string
                          format: date-time
                  pagination:
                    type: object
                    properties:
                      total:
                        type: integer
                      page:
                        type: integer
                      limit:
                        type: integer
                      hasMore:
                        type: boolean
              example:
                traceId: 0af7651916cd43dd8448eb211c80319c
                scores:
                  - id: f2c1a7e4-6b3d-4a95-8e10-c7d2b9f4a301
                    scorerId: completeness-scorer
                    scorerName: Completeness Scorer
                    spanId: b7ad6b7169203331
                    score: 0.85
                    reason: >-
                      The answer covers the refund window and asks for the order
                      number, but not the refund method.
                    source: TEST
                    threadId: thread_2f81c04a
                    createdAt: '2026-10-13T09:41:07.213Z'
                pagination:
                  total: 1
                  page: 0
                  limit: 50
                  hasMore: false
        '404':
          description: No such trace in this organization
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    description: The class of failure.
                  details:
                    type: string
                    description: What specifically went wrong.
              example:
                error: Not found
                details: 'Trace not found: 0af7651916cd43dd8448eb211c80319c'
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Organization API key, generated in studio.sidenet.ai. Backend only —
        never in a browser.

````

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