Skip to content

API

Pagination.

Lists come in pages, newest first. Follow the cursor until it's null.

Last updated 19 November 2026

Pages and cursors

Every list (/interviews, /candidates, /invitations) takes two query parameters and returns { data, nextCursor }.

ParameterTypeDescription
limitintegerItems per page, 1 to 100. Default 25. Another value is a 400 naming limit in issues.
cursorstringThe nextCursor of the previous page. Leave it out for the first page.
curl "https://api.testee.ai/v1/candidates?limit=100" \  -H "Authorization: Bearer $TESTEE_API_KEY"

Items are sorted newest first (by createdAt, then id), so a page never repeats or skips an item. nextCursor is null on the last page. Treat the cursor as opaque: its format can change.

Read every page

const candidates = [];let cursor = null;
do {  const url = new URL("https://api.testee.ai/v1/candidates");  url.searchParams.set("limit", "100");
  if (cursor) url.searchParams.set("cursor", cursor);  const res = await fetch(url, { headers: { Authorization: `Bearer ${process.env.TESTEE_API_KEY}` } });  const page = await res.json();  candidates.push(...page.data);  cursor = page.nextCursor;} while (cursor);