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

# Get Results

> Get comprehensive results for a specific interview including analysis, score, and the integrity report. The integrity report contains the overall risk, an explanation, and the per-check integrity flags (findings and passing checks) shown in the results Integrity section.



## OpenAPI

````yaml https://api.ropes.ai/api/docs/openapi.json get /api/public/results/{interviewId}
openapi: 3.0.0
info:
  title: Ropes Public API
  version: 1.0.0
  description: >-
    Public API for Ropes. Authenticate using your API key in the x-api-key
    header.
servers:
  - url: https://api.ropes.ai
    description: Production server
  - url: http://localhost:3001
    description: Local development server
security: []
paths:
  /api/public/results/{interviewId}:
    get:
      tags:
        - Results
      summary: Get Results
      description: >-
        Get comprehensive results for a specific interview including analysis,
        score, and the integrity report. The integrity report contains the
        overall risk, an explanation, and the per-check integrity flags
        (findings and passing checks) shown in the results Integrity section.
      parameters:
        - schema:
            type: string
            description: The unique identifier of the interview
          required: true
          description: The unique identifier of the interview
          name: interviewId
          in: path
      responses:
        '200':
          description: Successfully retrieved interview results
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResultDetails'
        '401':
          description: Unauthorized - Invalid or missing API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResultErrorResponse'
        '404':
          description: Interview result or problem not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResultErrorResponse'
        '500':
          description: Server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResultErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    ResultDetails:
      type: object
      properties:
        candidate_id:
          type: string
          description: Identifier of the candidate
        interview_id:
          type: string
          description: Identifier of the interview
        score:
          type: number
          nullable: true
          description: >-
            The aggregate score for the interview (0-100). Null when the
            interview is an ungraded video screening.
        analysis:
          type: array
          nullable: true
          items:
            $ref: '#/components/schemas/AnalysisItem'
          description: >-
            Detailed analysis broken down by dimension. Null when the interview
            is an ungraded video screening.
        completed_at:
          type: string
          nullable: true
          format: date-time
          description: ISO 8601 timestamp when the interview was completed
        integrity_report:
          $ref: '#/components/schemas/IntegrityReport'
        completion_time_seconds:
          type: number
          nullable: true
          description: Time taken to complete the interview in seconds
        problem_id:
          type: string
          description: Identifier of the problem/question
      required:
        - candidate_id
        - interview_id
        - score
        - analysis
        - completed_at
        - integrity_report
        - completion_time_seconds
        - problem_id
    ResultErrorResponse:
      type: object
      properties:
        error:
          type: string
          description: Error message
        message:
          type: string
          description: Error message (alternative field)
    AnalysisItem:
      type: object
      properties:
        key:
          type: string
          description: The key identifier for this analysis dimension
        name:
          type: string
          description: The human-readable name of this analysis dimension
        score:
          type: number
          description: The score for this dimension
        explanation:
          type: string
          description: Detailed explanation of the score
      required:
        - key
        - name
        - score
        - explanation
    IntegrityReport:
      type: object
      properties:
        risk:
          type: string
          enum:
            - low
            - medium
            - high
          description: >-
            Overall assessment integrity risk. Reflects all fraud signals plus
            any human override.
        explanation:
          type: string
          nullable: true
          description: Human-readable summary of the integrity assessment.
        flags:
          type: array
          items:
            $ref: '#/components/schemas/IntegrityFlag'
          description: >-
            Integrity findings that did not pass (critical, warning, notice, or
            skipped checks), matching the flags shown in the results Integrity
            section. Empty when there are no such findings.
        passing_flags:
          type: array
          items:
            $ref: '#/components/schemas/IntegrityFlag'
          description: >-
            Integrity checks the candidate cleared. Empty when there are no
            passing checks.
      required:
        - risk
        - explanation
        - flags
        - passing_flags
      description: >-
        Fraud detection and integrity analysis, including the per-check
        integrity flags.
    IntegrityFlag:
      type: object
      properties:
        id:
          type: string
          description: Stable machine identifier for the check that produced this finding.
        title:
          type: string
          description: Short human-readable name of the finding.
        description:
          type: string
          description: Human-readable explanation of the finding for this candidate.
        level:
          type: string
          enum:
            - critical
            - warning
            - notice
            - pass
            - skipped
          description: >-
            Severity of the finding. "pass" = check cleared; "skipped" = check
            could not be performed (e.g. missing input).
      required:
        - id
        - title
        - description
        - level
      additionalProperties: false
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````