Skip to main content
GET
/
merchant-interview-list
List interview definitions
curl --request GET \
  --url https://cool.jobmojito.com/functions/v1/merchant-interview-list \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "<string>",
      "merchant_id": "<string>",
      "name": "<string>",
      "emoji": "<string>",
      "type": "<string>",
      "type_avatar": "<string>",
      "status": "<string>",
      "visibility": "<string>",
      "mojito_language_code": "<string>",
      "speech_language_code": "<string>",
      "environment": "<string>",
      "is_ats": true,
      "is_multi_stage": true,
      "recording": "<string>",
      "recording_full_session": "<string>",
      "billing_single_position": true,
      "billing_single_position_end_at": "<string>",
      "cover_image_url": "<string>",
      "interview_count": 123,
      "interview_last": "<string>",
      "calc_duration": 123,
      "created_at": "<string>",
      "updated_at": "<string>"
    }
  ],
  "pagination": {
    "total": 137,
    "limit": 50,
    "offset": 0,
    "has_more": true
  }
}

Authorizations

Authorization
string
header
required

Supabase JWT access token, passed as Authorization: Bearer <token>.

Query Parameters

merchant_id
string<uuid>

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"

type
enum<string>
default:interview

Product type of interviews to list.

Available options:
interview,
coaching,
assessment,
public_avatar,
persona
Example:

"interview"

status
enum<string>

Filter by lifecycle status. Omit to include all statuses.

Available options:
draft,
active,
archived,
deleted,
preparing,
completed
Example:

"active"

show_public
enum<string>
default:false

Include interviews shared publicly across merchants (coaching/avatars).

Available options:
true,
false
Example:

"false"

show_demo
enum<string>
default:false

Include demo/sample interviews.

Available options:
true,
false
Example:

"false"

filter_text
string

Case-insensitive search on the interview name.

filter_emoji
string

Filter by the interview emoji marker.

limit
integer
default:50

Maximum number of records to return (1–1000).

Required range: 1 <= x <= 1000
Example:

50

offset
integer | null
default:0

Number of records to skip from the start of the result set.

Required range: x >= 0
Example:

0

Response

A page of interview definitions with pagination metadata.

data
object[]
required

The merchant's interview definitions for this page, newest-updated first.

pagination
object
required