Pagination

List endpoints return paginated results to maintain performance. TalentScreen uses cursor-based pagination for consistent results even as data changes.

Pagination Parameters

Pagination Response

Paginated responses include data array, pagination metadata, and next_cursor for fetching subsequent pages.

{
  "data": [
    { "id": "exam_123", "title": "Backend Developer Test" },
    { "id": "exam_124", "title": "Frontend Engineer Test" }
  ],
  "pagination": {
    "total": 47,
    "limit": 20,
    "has_more": true,
    "next_cursor": "eyJpZCI6ImV4YW1fMTI0In0="
  }
}

Fetching All Pages

Use the next_cursor value from each response to fetch subsequent pages. When has_more is false, you have retrieved all results.

async function fetchAll(endpoint) {
  const results = [];
  let cursor = null;
  
  do {
    const url = cursor 
      ? `${endpoint}?cursor=${cursor}`
      : endpoint;
    
    const response = await fetch(url, { headers });
    const data = await response.json();
    
    results.push(...data.data);
    cursor = data.pagination.next_cursor;
  } while (cursor);
  
  return results;
}

Performance Tips

Request only the page size you need. Cache results when appropriate. Use filtering and sorting parameters to reduce total result count. Monitor rate limits when paginating through large datasets.