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

# Get Table Sheet Score

> Retrieve Table sheet score data.

Retrieve the current score payload for a Table sheet.

When explicit scoring is not configured, PromptLayer returns the default score it can infer from output columns. Configured scoring responses include status and configuration metadata.


## OpenAPI

````yaml GET /api/public/v2/tables/{table_id}/sheets/{sheet_id}/score
openapi: 3.1.0
info:
  title: FastAPI
  version: 0.1.0
servers: []
security:
  - ApiKeyAuth: []
paths:
  /api/public/v2/tables/{table_id}/sheets/{sheet_id}/score:
    get:
      tags:
        - tables
      summary: Get Table Sheet Score
      description: >-
        Retrieve the current score payload for a Table sheet. Requests are
        scoped to the workspace associated with the API key; table, sheet,
        column, cell, operation, and version IDs must belong to that workspace.
      operationId: getTableSheetScore
      parameters:
        - name: X-API-KEY
          in: header
          required: true
          schema:
            type: string
          description: >-
            Your PromptLayer API key. The key's workspace scopes table resources
            for this request.
        - name: table_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Table ID.
        - name: sheet_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
          description: Table sheet ID.
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TableSheetScoreResponse'
        '400':
          description: Invalid workspace context.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Table or sheet not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
components:
  schemas:
    TableSheetScoreResponse:
      type: object
      title: TableSheetScoreResponse
      required:
        - success
        - sheet_id
        - scoring_type
        - columns
        - aggregate_score
        - total_rows
        - scored_rows
        - excluded_rows
        - calculated_at
        - score_matrix
        - score_matrix_metrics
        - status
        - score_calculation_error
        - has_custom_scoring
        - score_configuration
        - score_type
        - overall_score
        - details
        - aggregate
        - per_column
      properties:
        success:
          type: boolean
        sheet_id:
          type: string
          format: uuid
        scoring_type:
          type: string
          enum:
            - auto
            - boolean
            - numeric
            - custom
            - null
          nullable: true
        columns:
          type: array
          items:
            $ref: '#/components/schemas/TableSheetScoreColumn'
        aggregate_score:
          type: number
          nullable: true
        total_rows:
          type: integer
        scored_rows:
          type: integer
        excluded_rows:
          type: integer
        calculated_at:
          type: string
          format: date-time
          nullable: true
        score_matrix:
          type: array
          nullable: true
          items:
            type: array
            items:
              nullable: true
              oneOf:
                - type: number
                - type: string
                - $ref: '#/components/schemas/TableSheetScoreCellObject'
        score_matrix_metrics:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/TableSheetScoreMetric'
        status:
          type: string
          enum:
            - queued
            - running
            - completed
            - failed
            - null
          nullable: true
        score_calculation_error:
          type: string
          nullable: true
        has_custom_scoring:
          type: boolean
        score_configuration:
          nullable: true
          allOf:
            - $ref: '#/components/schemas/TableSheetScoreConfiguration'
        score_type:
          type: string
          enum:
            - none
            - single_column
            - multi_column
            - custom
        overall_score:
          type: number
          nullable: true
        details:
          additionalProperties: true
          type: object
        aggregate:
          additionalProperties: true
          type: object
        per_column:
          additionalProperties: true
          type: object
      additionalProperties: false
    ErrorResponse:
      type: object
      properties:
        success:
          type: boolean
          default: false
          description: Indicates that the request failed.
        message:
          type: string
          description: Human-readable error message.
        error:
          type: string
          description: Machine-readable or fallback error message.
      additionalProperties: true
      description: >-
        Standard error response. Some legacy endpoints may return either message
        or error.
    TableSheetScoreColumn:
      type: object
      title: TableSheetScoreColumn
      required:
        - column_id
        - title
        - score
        - included_count
        - excluded_count
      properties:
        column_id:
          type: string
          format: uuid
        title:
          type: string
        score:
          type: number
          nullable: true
        included_count:
          type: integer
        excluded_count:
          type: integer
        resolved_scoring_type:
          type: string
          enum:
            - auto
            - boolean
            - numeric
            - custom
            - null
          nullable: true
      additionalProperties: false
    TableSheetScoreCellObject:
      type: object
      title: TableSheetScoreCellObject
      required:
        - value
      properties:
        value:
          nullable: true
        positive_metric:
          type: boolean
          nullable: true
      additionalProperties: true
    TableSheetScoreMetric:
      type: object
      title: TableSheetScoreMetric
      required:
        - key
        - label
      properties:
        key:
          type: string
        label:
          type: string
        positive_metric:
          type: boolean
          nullable: true
      additionalProperties: false
    TableSheetScoreConfiguration:
      type: object
      title: TableSheetScoreConfiguration
      required:
        - score_type
        - score_config
      properties:
        score_type:
          type: string
          enum:
            - auto
            - boolean
            - numeric
            - custom
        score_config:
          additionalProperties: true
          type: object
      additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-KEY

````