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

# List interview results

> Paginated list of a merchant's interview results (the admin-portal results list), scoped to the merchant from the JWT or the optional merchant_id override. Capped at 1000 records per page.



## OpenAPI

````yaml https://cool.jobmojito.com/functions/v1/openapi get /merchant-result-list
openapi: 3.1.0
info:
  title: JobMojito API
  version: 1.0.0
  description: >-
    Public API for JobMojito, served by Supabase Edge Functions. Authenticate
    with a Supabase JWT access token via the Authorization header.
servers:
  - url: https://cool.jobmojito.com/functions/v1
    description: Production
security: []
tags:
  - name: Interviews
    description: >-
      Create, configure and manage interview / coaching / assessment
      definitions.
  - name: Results
    description: >-
      Interview results, transcripts, reports, re-attempt requests and
      analytics.
  - name: Candidates
    description: List and manage candidates.
  - name: Knowledge base
    description: Upload documents used to generate knowledge-base interviews.
  - name: Resume & Form verification
    description: Pre-screen candidates from resumes and forms.
  - name: Admin
    description: >-
      Account administration — invite team/coaching users, manage sub-merchants
      and avatar templates.
paths:
  /merchant-result-list:
    get:
      tags:
        - Results
      summary: List interview results
      description: >-
        Paginated list of a merchant's interview results (the admin-portal
        results list), scoped to the merchant from the JWT or the optional
        merchant_id override. Capped at 1000 records per page.
      parameters:
        - schema:
            type: string
            format: uuid
            description: >-
              Optional merchant to scope the results to. Honoured only when the
              caller is an admin or a sub-merchant operator; otherwise the
              merchant from the JWT is always used.
            example: 28106cba-1c27-4e53-b149-32113e5e8e31
          required: false
          name: merchant_id
          in: query
        - schema:
            type: string
            enum:
              - interview
              - coaching
              - assessment
              - public_avatar
              - persona
            default: interview
            description: Product type of results to list.
            example: interview
          required: false
          name: type
          in: query
        - schema:
            type: string
            enum:
              - decided-rejected
              - undecided
              - shortlist
              - decided-selected
              - completed
              - incomplete
              - archived-interview
              - public_avatar
              - archived-public_avatar
              - ''
            description: >-
              Filter by decision/completion state. Omit (or empty) to include
              all.
            example: undecided
          required: false
          name: tab
          in: query
        - schema:
            type: string
            enum:
              - pre-screening
              - interview
            description: >-
              Filter by pipeline step (pre-screening vs interview). Omit for
              both.
            example: interview
          required: false
          name: step
          in: query
        - schema:
            type: string
            format: uuid
            description: Filter to a single interview definition id.
          required: false
          name: interview_id
          in: query
        - schema:
            type: string
            format: uuid
            description: Filter to a single candidate (profile_interview) id.
          required: false
          name: profile_interview_id
          in: query
        - schema:
            type: string
            description: >-
              Comma-separated list of recruiter-risk keys to filter by (matches
              any).
          required: false
          name: risks
          in: query
        - schema:
            type: string
            enum:
              - score
              - created_at_newest
              - created_at_oldest
              - updated_at_newest
            default: created_at_newest
            description: Sort order of the result set.
            example: created_at_newest
          required: false
          name: order_by
          in: query
        - schema:
            type: string
            description: Case-insensitive search on candidate name or email.
          required: false
          name: filter_text
          in: query
        - schema:
            type: string
            description: Filter by the candidate emoji marker.
          required: false
          name: filter_emoji
          in: query
        - schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 50
            description: Maximum number of records to return (1–1000).
            example: 50
          required: false
          name: limit
          in: query
        - schema:
            type: integer
            nullable: true
            minimum: 0
            default: 0
            description: Number of records to skip from the start of the result set.
            example: 0
          required: false
          name: offset
          in: query
      responses:
        '200':
          description: A page of interview results with pagination metadata.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/MerchantResultListResponse'
        '401':
          description: Missing or invalid access token.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Caller is not permitted to read this merchant.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Validation error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Server error.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    MerchantResultListResponse:
      type: object
      properties:
        data:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
                description: Position result row id.
              interview_result_id:
                type: string
                nullable: true
                description: Interview result id (use with merchant-... detail endpoints).
              interview_result_pre_screening_id:
                type: string
                nullable: true
                description: Pre-screening result id, if any.
              merchant_id:
                type: string
                nullable: true
                description: Owning merchant id.
              profile_id:
                type: string
                nullable: true
                description: Candidate profile id.
              profile_interview_id:
                type: string
                nullable: true
                description: Candidate (profile_interview) id.
              definition_id:
                type: string
                nullable: true
                description: Interview definition id.
              candidate_name:
                type: string
                nullable: true
                description: Candidate name.
              candidate_email:
                type: string
                nullable: true
                description: Candidate email.
              position_name:
                type: string
                nullable: true
                description: Position / interview name.
              position_step:
                type: string
                nullable: true
                description: Pipeline step.
              type:
                type: string
                nullable: true
                description: Product type.
              emoji:
                type: string
                nullable: true
                description: Emoji marker.
              external_id:
                type: string
                nullable: true
                description: External identifier.
              mojito_language_code:
                type: string
                nullable: true
                description: Platform language code.
              status:
                type: string
                nullable: true
                description: Row status.
              coach_status:
                type: string
                nullable: true
                description: Interview/coach status (started/completed/…).
              decision_status:
                type: string
                nullable: true
                description: Hiring decision (selected/rejected/…).
              interview_started:
                type: boolean
                nullable: true
                description: Whether the interview was started.
              is_multi_stage:
                type: boolean
                nullable: true
                description: Whether multi-stage.
              is_test:
                type: boolean
                nullable: true
                description: Whether a test result.
              recruiter_shortlist:
                type: boolean
                nullable: true
                description: Whether recruiter-shortlisted.
              recruiter_risks:
                nullable: true
                description: Detected recruiter risk flags (jsonb).
              duration_ds:
                type: number
                nullable: true
                description: Duration in deciseconds.
              score:
                type: number
                nullable: true
                description: Overall score.
              score_simulation:
                type: number
                nullable: true
                description: Simulated overall score.
              score_sentiment:
                type: number
                nullable: true
                description: Sentiment sub-score.
              score_words_per_minute:
                type: number
                nullable: true
                description: Speaking-pace sub-score.
              score_interview_ai:
                type: number
                nullable: true
                description: AI interview sub-score.
              score_answer_ai:
                type: number
                nullable: true
                description: AI answer sub-score.
              score_pronunciation:
                type: number
                nullable: true
                description: Pronunciation sub-score.
              processing_status:
                type: string
                nullable: true
                description: Processing status.
              processing_error:
                type: string
                nullable: true
                description: Processing error, if any.
              kyc_processing_status:
                type: string
                nullable: true
                description: KYC processing status.
              position_result_step_id:
                type: string
                nullable: true
                description: Position result step id.
              created_at:
                type: string
                nullable: true
                description: Creation timestamp (ISO 8601).
              updated_at:
                type: string
                nullable: true
                description: Last update timestamp (ISO 8601).
            required:
              - id
            additionalProperties:
              nullable: true
          description: The merchant's interview results for this page.
        pagination:
          $ref: '#/components/schemas/Pagination'
      required:
        - data
        - pagination
    Error:
      type: object
      properties:
        error:
          type: string
          example: Field is required.
        name:
          type: string
          example: interview_result_id
      required:
        - error
    Pagination:
      type: object
      properties:
        total:
          type: integer
          description: Total matching records across all pages.
          example: 137
        limit:
          type: integer
          description: Page size used for this response.
          example: 50
        offset:
          type: integer
          description: Offset used for this response.
          example: 0
        has_more:
          type: boolean
          description: >-
            True when more records exist beyond this page (offset + returned <
            total).
          example: true
      required:
        - total
        - limit
        - offset
        - has_more
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Supabase JWT access token, passed as `Authorization: Bearer <token>`.'

````