> ## 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.

# List Interviews for Job Opening

> Returns a list of interviews for the specified job opening. Each interview includes transcript and assessment details.



## OpenAPI

````yaml GET /job-openings/{JOB_OPENING_ID}/interviews
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:
    get:
      description: >-
        Returns a list of interviews for the specified job opening. Each
        interview includes transcript and assessment details.
      parameters:
        - name: JOB_OPENING_ID
          in: path
          description: ID of the job opening to list interviews for
          required: true
          schema:
            type: string
            format: uuid
        - name: page
          in: query
          description: Page number for pagination
          schema:
            type: integer
            default: 1
        - name: limit
          in: query
          description: Number of items per page
          schema:
            type: integer
            default: 20
      responses:
        '200':
          description: List of interviews with pagination details
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      interviews:
                        type: array
                        items:
                          $ref: '#/components/schemas/Interview'
                  total_pages:
                    type: integer
                  total:
                    type: integer
                  page:
                    type: integer
                  limit:
                    type: integer
              example:
                data:
                  interviews:
                    - 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://videostorage.com/12345
                          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
                total_pages: 1
                total: 1
                page: 1
                limit: 20
        '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

````