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

# Get interview

> Returns one completed, non-hidden interview belonging to the API key organization. Unlike the study-scoped list, this endpoint does not require the parent study to be completed.



## OpenAPI

````yaml /api-reference/openapi.yml get /interviews/{id}
openapi: 3.1.1
info:
  title: Conveo API
  version: '1.0'
servers:
  - url: https://app.conveo.ai/public-api/v1
security:
  - bearerAuth: []
  - apiKeyAuth: []
paths:
  /interviews/{id}:
    get:
      summary: Get interview
      description: >-
        Returns one completed, non-hidden interview belonging to the API key
        organization. Unlike the study-scoped list, this endpoint does not
        require the parent study to be completed.
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: A single interview
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Interview'
        '401':
          description: Unauthorized
        '404':
          description: Interview not found
components:
  schemas:
    Interview:
      type: object
      properties:
        id:
          type: string
          example: cm393cvz80bdpmcedfzacog26
        participant:
          type:
            - object
            - 'null'
          description: >-
            Participant identity when available. The display name uses first
            name and last initial.
          properties:
            id:
              type: string
              example: cm14zq5t10egyfkyrfy34ihlc
            name:
              type:
                - string
                - 'null'
              example: John S
        facets:
          type: array
          description: List of facets associated with the interview
          items:
            $ref: '#/components/schemas/Facet'
          example:
            - label: Age
              values:
                - '35'
            - label: Gender
              values:
                - Female
            - label: Country
              values:
                - United States
            - label: Car Ownership
              values:
                - Electric Vehicle
                - Previous ICE Owner
            - label: Opinion on Jaguar's Strategy
              values:
                - Positive impression
                - Interested in future models
        videoDownloadURL:
          type:
            - string
            - 'null'
          format: uri
          description: >-
            Temporary URL to download the stored interview video; null if
            storage details are unavailable or URL generation fails. The URL
            expires after 15 minutes. Request the interview again for a fresh
            URL.
          example: https://...
        transcriptAsWebVTT:
          type:
            - string
            - 'null'
          description: >-
            Participant-response messages in WebVTT format, using original
            message text. Interviewer questions are not included. Null when no
            response messages are available. Missing timings can produce zero or
            equal start and end times.
        createdAt:
          type: string
          format: date-time
        updatedAt:
          type: string
          format: date-time
    Facet:
      type: object
      description: A facet representing a labeled set of values
      properties:
        label:
          type: string
          description: The label or name of the facet
        values:
          type: array
          description: List of values associated with this facet
          items:
            type: string
      required:
        - label
        - values
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Organization API key supplied as a Bearer token. MCP OAuth tokens are
        not accepted by these REST endpoints.
    apiKeyAuth:
      type: apiKey
      in: header
      name: Conveo-Api-Key

````