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

# Fetch Interview

> Return the interview for the given ID.



## OpenAPI

````yaml GET /job-openings/{JOB_OPENING_ID}/interviews/{INTERVIEW_ID}
openapi: 3.0.1
info:
  title: Alpharun API
  description: Alpharun REST API reference
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.alpharun.com/api/v1
security:
  - bearerAuth: []
paths:
  /job-openings/{JOB_OPENING_ID}/interviews/{INTERVIEW_ID}:
    get:
      description: Return the interview for the given ID.
      parameters:
        - name: JOB_OPENING_ID
          in: path
          description: ID of the job opening
          required: true
          schema:
            type: string
            format: uuid
        - name: INTERVIEW_ID
          in: path
          description: ID of the interview to fetch
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: Interview details
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      interview:
                        $ref: '#/components/schemas/Interview'
              example:
                data:
                  interview:
                    id: abc123
                    job_opening_id: def456
                    job_opening:
                      id: def456
                      name: Customer Support Representative
                    status: completed
                    contact:
                      first_name: Miguel
                      last_name: Rodriguez
                      email: miguel.rodriguez@alpharun.com
                      phone_number: null
                      resume_url: https://api.alpharun.com/api/v1/resumes/abc123.pdf
                      custom_fields:
                        - key: location
                          name: Location
                          type: string
                          value: New York
                    started_at: '2024-05-29T22:43:16.029+00:00'
                    completed_at: '2024-05-29T22:43:16.029+00:00'
                    transcript_fragments:
                      - role: agent
                        transcript: Hello, is this Miguel Rodriguez?
                      - role: participant
                        transcript: Yes, this is Miguel. How are you?
                      - role: agent
                        transcript: >-
                          I'm doing well, thank you. Let's get started with the
                          interview. Can you describe any previous experience in
                          customer support that you have?
                      - role: participant
                        transcript: >-
                          Certainly. I've been working in customer support for
                          over two years now. My first role was at a call center
                          where I handled inquiries and complaints from
                          customers. Recently, I worked with an e-commerce
                          company where I provided support via chat and email.
                      - role: agent
                        transcript: >-
                          That's great to hear. What motivated you to apply for
                          this position at Acme, and what interests you about
                          working in a BPO environment?
                      - role: participant
                        transcript: >-
                          I have always been drawn to roles that require strong
                          interpersonal skills and problem-solving abilities.
                          What's appealing about Acme is its reputation for
                          excellent team collaboration and its dedication to
                          client satisfaction. The BPO environment facilitates
                          constant learning and growth, which is very exciting
                          for me.
                      - role: agent
                        transcript: >-
                          How would you rate your English proficiency, and in
                          what ways have you used English in your previous
                          customer support roles?
                      - role: participant
                        transcript: >-
                          I would rate my English proficiency at a C1 level. In
                          my previous roles, I communicated with clients
                          exclusively in English, both verbally and in writing,
                          including providing detailed explanations and
                          resolving issues effectively.
                      - role: agent
                        transcript: >-
                          Can you provide an example of a time when you
                          collaborated with a team to resolve a customer issue?
                      - role: participant
                        transcript: >-
                          Certainly. At my last job, we had a situation where a
                          customer's package was lost. I coordinated with the
                          logistics team to track the item, liaised with the
                          warehouse to confirm inventory, and worked with my
                          supervisor to arrange a replacement. Throughout this
                          process, clear and constant communication was key.
                      - role: agent
                        transcript: >-
                          How do you handle high-pressure situations or
                          difficult customers when providing support?
                      - role: participant
                        transcript: >-
                          I stay calm and listen actively. It's important to let
                          the customer express their frustration while I calmly
                          gather necessary information. I then assure them that
                          I'm here to help and quickly come up with a solution.
                          Staying patient and empathetic is crucial.
                      - role: agent
                        transcript: >-
                          What strategies do you use to ensure effective
                          communication and support for clients?
                      - role: participant
                        transcript: >-
                          Clear and simple language is essential. I make sure to
                          be concise but thorough, and I always confirm
                          understanding by asking follow-up questions. Regular
                          updates and follow-through are also important to keep
                          the client informed.
                      - role: agent
                        transcript: >-
                          Why do you believe it is important to provide
                          excellent customer service, especially in the context
                          of supporting American clients?
                      - role: participant
                        transcript: >-
                          Providing excellent customer service builds trust and
                          loyalty, which are key to any business. American
                          clients, in particular, appreciate responsive and
                          friendly interaction. It's important to meet their
                          expectations to foster repeat business and positive
                          word-of-mouth.
                      - role: agent
                        transcript: >-
                          How do you stay motivated and maintain a positive
                          attitude while handling repetitive or challenging
                          tasks in customer support?
                      - role: participant
                        transcript: >-
                          I remind myself of the impact my work has on people's
                          lives. Small gestures, like resolving an issue or
                          making someone's day better, are very rewarding. I
                          also take brief breaks to recharge and keep a positive
                          mindset.
                      - role: agent
                        transcript: >-
                          Can you describe a significant achievement in your
                          customer support career that you are particularly
                          proud of?
                      - role: participant
                        transcript: >-
                          Sure. One time, I was able to turn around a difficult
                          situation with a very upset customer by going above
                          and beyond to resolve their issue. This led to the
                          customer later submitting a commendation for my
                          assistance, which was a very proud moment for me.
                      - role: agent
                        transcript: >-
                          What software or tools are you familiar with that can
                          aid in providing exceptional customer service?
                      - role: participant
                        transcript: >-
                          I am well-versed in using CRM software like Salesforce
                          and Zendesk. I also have experience with live chat
                          tools, email management systems, and basic Excel
                          functions for reporting purposes.
                      - role: agent
                        transcript: >-
                          Thank you, Miguel. We will be in touch soon regarding
                          the next steps.
                      - role: participant
                        transcript: >-
                          Thank you for the opportunity. I look forward to
                          hearing from you.
                    insights:
                      assessment_score: 5
                      strengths:
                        - >-
                          Demonstrates extensive customer support experience
                          with both phone and digital channels
                        - >-
                          Shows excellent English proficiency at C1 level with
                          clear communication
                        - >-
                          Exhibits strong problem-solving abilities through
                          concrete examples
                        - >-
                          Maintains composure and empathy when handling
                          difficult situations
                        - >-
                          Displays proficiency with relevant customer service
                          tools and CRM systems
                      weaknesses:
                        - >-
                          Could benefit from more experience in a BPO
                          environment
                    calls:
                      - id: abc123
                        recording_url: >-
                          https://api.alpharun.com/api/v1/projects/12345/interviews/56789/calls/xyz123/recording
                        video_url: >-
                          https://api.alpharun.com/api/v1/projects/12345/interviews/56789/calls/xyz123/video
                        started_at: '2024-05-29T22:43:16.029+00:00'
                        ended_at: '2024-05-29T22:48:32.145+00:00'
                    assessment_criteria:
                      - name: CEFR English level estimate
                        value: C1
                        commentary: >-
                          The candidate demonstrates C1 level fluency and has a
                          neutral American accent. They articulate confidently
                          and show a strong command over technical terminology
                          in the software development field. Their grammar is
                          accurate, vocabulary is broad, and they respond to
                          questions with ease, showcasing coherent and complex
                          sentence structures. Overall, their proficiency is
                          indicative of an advanced level of English.
                      - name: Proficient in React, Node.js, and TypeScript
                        value: true
                        commentary: >-
                          Miguel demonstrates proficiency with all three
                          technologies in past projects.
                    data_extraction_fields:
                      - name: >-
                          Level of customer support experience (Scale of 1-5, 1
                          = No Experience, 5 = Expert)
                        type: number
                        value: 2
                        commentary: >-
                          Miguel has 1 year of experience in phone based
                          customer support.
                      - name: Has a valid visa to work in the US
                        type: boolean
                        value: true
                        commentary: Miguel has a valid H-1B visa.
                    custom_fields:
                      - key: ats_applicant_id
                        name: ATS applicant ID
                        type: string
                        value: 1234asdf
        '400':
          description: Unexpected error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    Interview:
      type: object
      required:
        - id
        - job_opening_id
        - job_opening
        - status
        - contact
        - started_at
        - completed_at
        - transcript_fragments
        - insights
      properties:
        id:
          type: string
          description: ID of the interview
        job_opening_id:
          type: string
          description: ID of the job opening this interview belongs to
        job_opening:
          description: The job opening associated with this interview
          type: object
          properties:
            id:
              type: string
              description: ID of the job opening
            name:
              type: string
              description: Name of the job opening
        status:
          type: string
          enum:
            - in_progress
            - completed
          description: >-
            Current status of the interview: "in_progress" (interviewee has not
            answered all questions) or "completed"
        contact:
          type: object
          properties:
            first_name:
              type: string
              nullable: true
              description: First name of the interviewee
            last_name:
              type: string
              nullable: true
              description: Last name of the interviewee
            email:
              type: string
              nullable: true
              description: Email address of the interviewee
            phone_number:
              type: string
              nullable: true
              description: Phone number of the interviewee
            resume_url:
              type: string
              nullable: true
              description: URL of the interviewee's resume
            custom_fields:
              type: array
              description: List of custom fields on the contact
              items:
                type: object
                required:
                  - key
                  - name
                  - type
                  - value
                properties:
                  key:
                    type: string
                    description: Machine-readable key of the custom field
                  name:
                    type: string
                    description: Human-friendly name of the custom field
                  type:
                    type: string
                    enum:
                      - text
                      - number
                      - boolean
                    description: Data type of the custom field
                  value:
                    oneOf:
                      - type: string
                      - type: number
                      - type: boolean
                    nullable: true
                    description: Value of the custom field
        started_at:
          type: string
          format: date-time
          description: ISO 8601 timestamp of when the interview started
        completed_at:
          type: string
          format: date-time
          description: ISO 8601 timestamp of when the interview was completed
        transcript_fragments:
          type: array
          items:
            type: object
            required:
              - role
              - transcript
            properties:
              role:
                type: string
                enum:
                  - agent
                  - participant
                description: Role of the speaker ("agent" or "participant")
              transcript:
                type: string
                description: The spoken content
          description: List of transcript fragments in chronological order
        insights:
          type: object
          properties:
            assessment_score:
              type: number
              nullable: true
              description: >-
                An overall rating (1 to 5) of how qualified the candidate is for
                this role, based on the assessment criteria
            strengths:
              type: array
              items:
                type: string
              nullable: true
              description: >-
                List of candidate's key strengths identified during the
                interview
            weaknesses:
              type: array
              items:
                type: string
              nullable: true
              description: >-
                List of candidate's key areas for improvement identified during
                the interview
          description: >-
            AI-generated insights for this interview. Note that insights are
            only generated for completed interviews, so these values may be null
            for partially completed interviews.
        calls:
          type: array
          items:
            type: object
            required:
              - id
              - recording_url
              - started_at
              - ended_at
            properties:
              id:
                type: string
                description: Unique identifier for the call
              recording_url:
                type: string
                description: URL to access the recording of the call
              video_url:
                type: string
                description: Pre-signed URL to download the video recording, if available
              started_at:
                type: string
                format: date-time
                description: ISO 8601 timestamp of when the call started
              ended_at:
                type: string
                format: date-time
                description: ISO 8601 timestamp of when the call ended
          description: List of calls associated with this interview
        assessment_criteria:
          type: array
          items:
            type: object
            required:
              - name
              - value
              - commentary
            properties:
              name:
                type: string
                description: Name of the assessment criteria
              value:
                oneOf:
                  - type: string
                  - type: boolean
                description: Value of the assessment criteria
              commentary:
                type: string
                description: Commentary on the assessment criteria
          description: List of assessment criteria for the interview
        data_extraction_fields:
          type: array
          items:
            type: object
            required:
              - name
              - type
              - value
              - commentary
            properties:
              name:
                type: string
                description: Name of the data extraction field
              type:
                type: string
                enum:
                  - number
                  - boolean
                description: Type of the data extraction field
              value:
                oneOf:
                  - type: number
                  - type: boolean
                nullable: true
                description: Value of the field extracted from the interview
              commentary:
                type: string
                nullable: true
                description: Commentary explaining the extracted value
          description: List of data extraction fields extracted from the interview
        custom_fields:
          type: array
          description: List of custom fields on the interview
          items:
            type: object
            required:
              - key
              - name
              - type
              - value
            properties:
              key:
                type: string
                description: Machine-readable key of the custom field
              name:
                type: string
                description: Human-friendly name of the custom field
              type:
                type: string
                enum:
                  - text
                  - number
                  - boolean
                description: Data type of the custom field
              value:
                oneOf:
                  - type: string
                  - type: number
                  - type: boolean
                nullable: true
                description: Value of the custom field
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: integer
          format: int32
        message:
          type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````