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

# Get Graded Results

> Get decision-first inference from paired numeric judgments.



## OpenAPI

````yaml /openapi.json get /v1/experiments/{experiment_id}/graded-results
openapi: 3.1.0
info:
  description: Customer-owned evaluation lifecycle API.
  title: HeyBee Public API
  version: 1.0.0
servers:
  - description: Production
    url: https://api.heybee.app
security: []
paths:
  /v1/experiments/{experiment_id}/graded-results:
    get:
      tags:
        - Analytics
      summary: Get Graded Results
      description: Get decision-first inference from paired numeric judgments.
      operationId: get_graded_results_v1_experiments__experiment_id__graded_results_get
      parameters:
        - in: path
          name: experiment_id
          required: true
          schema:
            format: uuid
            title: Experiment Id
            type: string
        - in: header
          name: authorization
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Authorization
        - in: header
          name: X-API-Key
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: X-Api-Key
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GradedResultsResponse'
          description: Successful Response
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
          description: Validation Error
      security:
        - BearerAuth: []
        - ApiKeyAuth: []
components:
  schemas:
    GradedResultsResponse:
      description: Decision-first results derived from paired numeric scores.
      properties:
        analysis_available:
          title: Analysis Available
          type: boolean
        candidates:
          items:
            $ref: '#/components/schemas/GradedCandidateResultResponse'
          title: Candidates
          type: array
        computed_at:
          format: date-time
          title: Computed At
          type: string
        criteria:
          items:
            $ref: '#/components/schemas/GradedCriterionResultResponse'
          title: Criteria
          type: array
        critical_criteria_passed:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Critical Criteria Passed
        decision_status:
          anyOf:
            - type: string
            - type: 'null'
          title: Decision Status
        expected_advantage:
          anyOf:
            - type: number
            - type: 'null'
          title: Expected Advantage
        low_absolute_quality:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Low Absolute Quality
        meaningful_margin:
          anyOf:
            - maximum: 1
              minimum: 0
              type: number
            - type: 'null'
          title: Meaningful Margin
        optimization:
          anyOf:
            - $ref: '#/components/schemas/GradedOptimizationResultResponse'
            - type: 'null'
        probability_best:
          anyOf:
            - maximum: 1
              minimum: 0
              type: number
            - type: 'null'
          title: Probability Best
        reason:
          anyOf:
            - type: string
            - type: 'null'
          title: Reason
        winner_candidate_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
          title: Winner Candidate Id
        winner_candidate_key:
          anyOf:
            - type: string
            - type: 'null'
          title: Winner Candidate Key
        winner_candidate_label:
          anyOf:
            - type: string
            - type: 'null'
          title: Winner Candidate Label
      required:
        - analysis_available
        - computed_at
      title: GradedResultsResponse
      type: object
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          title: Detail
          type: array
      title: HTTPValidationError
      type: object
    GradedCandidateResultResponse:
      description: Continuous evidence summary for one candidate.
      properties:
        candidate_id:
          format: uuid
          title: Candidate Id
          type: string
        candidate_key:
          title: Candidate Key
          type: string
        candidate_label:
          anyOf:
            - type: string
            - type: 'null'
          title: Candidate Label
        confidence_interval:
          anyOf:
            - maxItems: 2
              minItems: 2
              prefixItems:
                - type: number
                - type: number
              type: array
            - type: 'null'
          title: Confidence Interval
        effect:
          title: Effect
          type: number
        normalized_score:
          maximum: 1
          minimum: 0
          title: Normalized Score
          type: number
        probability_best:
          anyOf:
            - maximum: 1
              minimum: 0
              type: number
            - type: 'null'
          title: Probability Best
      required:
        - candidate_id
        - candidate_key
        - normalized_score
        - effect
      title: GradedCandidateResultResponse
      type: object
    GradedCriterionResultResponse:
      description: Independent inference result for one scored criterion.
      properties:
        axis_key:
          title: Axis Key
          type: string
        candidates:
          items:
            $ref: '#/components/schemas/GradedCandidateResultResponse'
          title: Candidates
          type: array
        critical:
          title: Critical
          type: boolean
        cross_input_consistency:
          maximum: 1
          minimum: 0
          title: Cross Input Consistency
          type: number
        decision_passed:
          title: Decision Passed
          type: boolean
        eligible_input_count:
          minimum: 0
          title: Eligible Input Count
          type: integer
        expected_advantage:
          title: Expected Advantage
          type: number
        label:
          title: Label
          type: string
        leader_candidate_id:
          anyOf:
            - format: uuid
              type: string
            - type: 'null'
          title: Leader Candidate Id
        meaningful_margin:
          maximum: 1
          minimum: 0
          title: Meaningful Margin
          type: number
        probability_best:
          maximum: 1
          minimum: 0
          title: Probability Best
          type: number
        weight:
          exclusiveMinimum: 0
          title: Weight
          type: number
      required:
        - axis_key
        - label
        - weight
        - critical
        - meaningful_margin
        - eligible_input_count
        - probability_best
        - expected_advantage
        - cross_input_consistency
        - decision_passed
      title: GradedCriterionResultResponse
      type: object
    GradedOptimizationResultResponse:
      description: Continuous PPC result combined after independent criterion fits.
      properties:
        baseline_mse:
          anyOf:
            - minimum: 0
              type: number
            - type: 'null'
          title: Baseline Mse
        criteria:
          items:
            $ref: '#/components/schemas/GradedOptimizationCriterionResponse'
          title: Criteria
          type: array
        held_out_count:
          minimum: 0
          title: Held Out Count
          type: integer
        model_mse:
          anyOf:
            - minimum: 0
              type: number
            - type: 'null'
          title: Model Mse
        observation_count:
          minimum: 0
          title: Observation Count
          type: integer
        parameters:
          items:
            $ref: '#/components/schemas/GradedOptimizationParameterResponse'
          title: Parameters
          type: array
        predictive_skill:
          anyOf:
            - maximum: 1
              minimum: -1
              type: number
            - type: 'null'
          title: Predictive Skill
        stability:
          maximum: 1
          minimum: 0
          title: Stability
          type: number
      required:
        - observation_count
        - held_out_count
        - stability
      title: GradedOptimizationResultResponse
      type: object
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          title: Location
          type: array
        msg:
          title: Message
          type: string
        type:
          title: Error Type
          type: string
      required:
        - loc
        - msg
        - type
      title: ValidationError
      type: object
    GradedOptimizationCriterionResponse:
      description: Chronological out-of-sample optimization fit for one criterion.
      properties:
        axis_key:
          title: Axis Key
          type: string
        baseline_mse:
          anyOf:
            - minimum: 0
              type: number
            - type: 'null'
          title: Baseline Mse
        held_out_count:
          minimum: 0
          title: Held Out Count
          type: integer
        label:
          title: Label
          type: string
        model_mse:
          anyOf:
            - minimum: 0
              type: number
            - type: 'null'
          title: Model Mse
        observation_count:
          minimum: 0
          title: Observation Count
          type: integer
        parameters:
          items:
            $ref: '#/components/schemas/GradedOptimizationParameterResponse'
          title: Parameters
          type: array
        predictive_skill:
          anyOf:
            - maximum: 1
              minimum: -1
              type: number
            - type: 'null'
          title: Predictive Skill
        stability:
          maximum: 1
          minimum: 0
          title: Stability
          type: number
        weight:
          exclusiveMinimum: 0
          title: Weight
          type: number
      required:
        - axis_key
        - label
        - weight
        - observation_count
        - held_out_count
        - stability
      title: GradedOptimizationCriterionResponse
      type: object
    GradedOptimizationParameterResponse:
      description: Continuous parameter signal derived from paired score differences.
      properties:
        effect:
          title: Effect
        importance:
          maximum: 1
          minimum: 0
          title: Importance
          type: number
        parameter_name:
          title: Parameter Name
          type: string
        parameter_type:
          title: Parameter Type
          type: string
        recommended_value:
          title: Recommended Value
        uncertainty:
          anyOf:
            - minimum: 0
              type: number
            - type: 'null'
          title: Uncertainty
      required:
        - parameter_name
        - parameter_type
        - importance
      title: GradedOptimizationParameterResponse
      type: object
  securitySchemes:
    BearerAuth:
      bearerFormat: Supabase JWT
      scheme: bearer
      type: http
    ApiKeyAuth:
      in: header
      name: X-API-Key
      type: apiKey

````