---
title: "List interviewers"
method: GET
path: "/v1/interviewers"
tags: ["Themes & Interviewers"]
---

# List interviewers

`GET /v1/interviewers`

## Request

- Base URL: `https://api.subo.ai`
- URL: `https://api.subo.ai/v1/interviewers`
- Auth: API key in header `X-API-Key`

List available AI interviewer personas. Premium-only personas are filtered by community tier.

## Response `200`

List of interviewer personas

- object
  - `data` Interviewer[]
    - `id` integer
    - `name` string
    - `description` string, nullable
    - `avatar_url` string, nullable
    - `tone` string, nullable
    - `style` string, nullable
    - `formality` string, nullable
    - `is_premium` boolean

## Other responses

- `401`: Invalid or missing API key
- `429`: Rate limit exceeded — wait `retry_after` seconds before retrying. The same value appears in the `Retry-After` header.

---

[API](https://skmtc.dev/subo/apis/subo-api.md) · [All operations](https://skmtc.dev/subo/apis/subo-api/llms.txt) · [OpenAPI document](https://skmtc.dev/subo/apis/subo-api/revisions/12eab2ae4505?raw)