انتقل إلى المحتوى

API

Interviews.

The published interviews of your company, the ones you can invite candidates to.

آخر تحديث 19 نوفمبر 2026

وثائق المطورين متاحة باللغة الإنجليزية فقط.

The interview object

FieldTypeDescription
idstringUse it as interviewId when inviting
titlestringThe interview's name, as candidates see it
roleTitlestringThe role it's for, in the published version
senioritystringThe published version's level: intern, junior, mid, senior, staff or principal
durationMinintegerThe published version's planned length in minutes
blockCountintegerHow many blocks (Conversation, Quiz, Coding, Whiteboard…) the published version has
createdAtdate-timeWhen the interview was created

List published interviews

GET/v1/interviewsScope interviews:read

Interviews never published are left out, and unpublished draft changes never show: every value is the version candidates get. Takes limit and cursor (see Pagination).

curl https://api.testee.ai/v1/interviews \  -H "Authorization: Bearer $TESTEE_API_KEY"
Response
{  "data": [    {      "id": "iv_mh3k2p9x4f7a2c",      "title": "Backend engineer screen",      "roleTitle": "Backend engineer",      "seniority": "senior",      "durationMin": 30,      "blockCount": 4,      "createdAt": "2026-11-02T09:14:05.000Z"    }  ],  "nextCursor": "eyJjIjoiMjAyNi0xMS0wMlQwOToxNDowNS4wMDBaIiwiaSI6Iml2XzEifQ"}