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

# Get span assessment by ID

> Retrieve a single span assessment by its identifier.

Returns the assessment's type and content fields, the span and trace it is
attached to, and the identity that created it. Returns 404 if no assessment
with that id exists for the caller's account. Use the list endpoint instead
when you have a span or trace id rather than an assessment id.



## OpenAPI

````yaml https://api.sgp.scale.com/openapi-versions/v5/openapi.json get /v5/span-assessments/{span_assessment_id}
openapi: 3.1.0
info:
  title: EGP API V5
  description: >-
    This is the parent API for all EGP APIs. If you are looking for the EGP API,
    please go to https://api.egp.scale.com/docs.
  contact:
    name: Scale Generative AI Platform
    url: https://scale.com/genai-platform
  version: 0.1.0
servers:
  - url: https://api.egp.scale.com
security: []
paths:
  /v5/span-assessments/{span_assessment_id}:
    get:
      tags:
        - Span Assessment
      summary: Get span assessment by ID
      description: >-
        Retrieve a single span assessment by its identifier.


        Returns the assessment's type and content fields, the span and trace it
        is

        attached to, and the identity that created it. Returns 404 if no
        assessment

        with that id exists for the caller's account. Use the list endpoint
        instead

        when you have a span or trace id rather than an assessment id.
      operationId: GET-V5-/v5/span-assessments/span_assessment_id
      parameters:
        - name: span_assessment_id
          in: path
          required: true
          schema:
            type: string
            title: Span Assessment Id
        - name: x-selected-account-id
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Account ID Header
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SpanAssessment'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    SpanAssessment:
      properties:
        object:
          type: string
          const: span.assessment
          title: Object
          default: span.assessment
        comment:
          title: Comment
          description: Raw text feedback
          type: string
        rating:
          title: Rating
          description: Numerical rating (1-5)
          type: integer
          maximum: 5
          minimum: 1
        approval:
          $ref: '#/components/schemas/ApprovalStatus'
          description: Approval status (approved/rejected)
        rubric:
          title: Rubric
          description: Rule key-value pairs for rubric evaluation
          additionalProperties:
            type: string
          type: object
        metadata:
          title: Metadata
          description: Arbitrary JSON object for additional data
          additionalProperties: true
          type: object
        overwrite:
          title: Overwrite
          description: User corrections to span output
          additionalProperties: true
          type: object
        assessment_id:
          type: string
          title: Assessment Id
          description: Unique identifier for the assessment
        trace_id:
          type: string
          title: Trace Id
          description: The trace this assessment is attached to
        span_id:
          type: string
          title: Span Id
          description: The span this assessment is attached to
        created_by:
          type: string
          title: Created By
          description: User who submitted the assessment
        assessment_type:
          $ref: '#/components/schemas/AssessmentType'
          description: Type of assessment
        account_id:
          title: Account Id
          description: Account this assessment belongs to
          type: string
        created_at:
          title: Created At
          description: When this assessment was created
          type: string
          format: date-time
        updated_at:
          title: Updated At
          description: When this assessment was last updated
          type: string
          format: date-time
      additionalProperties: true
      type: object
      required:
        - assessment_id
        - trace_id
        - span_id
        - created_by
        - assessment_type
      description: Response model for span assessment
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ApprovalStatus:
      type: string
      enum:
        - approved
        - rejected
      title: ApprovalStatus
      description: Status options for approval assessments
    AssessmentType:
      type: string
      enum:
        - comment
        - rating
        - approval
        - rubric
        - metadata
        - overwrite
      title: AssessmentType
      description: Types of assessments that can be provided
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          title: Error Type
          type: string
        input:
          title: Input
        ctx:
          type: object
          title: Context
          additionalProperties: true
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: x-api-key

````