Skip to main content
GET
List applicants with advanced filters

Authorizations

Authorization
string
header
required

OAuth 2.1 authorization code + PKCE (S256). Tokens are tenant-bound (company_id) and scoped. Discover endpoints via /.well-known/oauth-authorization-server.

Query Parameters

limit
integer
default:25

Page size (default 25, max 100).

Required range: 1 <= x <= 100
cursor
string

Opaque pagination cursor from a prior response's nextCursor.

jobId
string
required

The job ID to list applicants for (required; ApplicantsRequestSchema enforces a non-empty string).

status
string

Applicant status filter (e.g. 'Waiting Review', 'Viewed', 'Accepted', 'Declined', 'Bookmarked'); defaults to 'all'.

filters
string

Advanced filter object as a JSON-encoded string (AdvancedUserFiltersSchema: q, creatorVerified, hasTopPosts, hasThreePosts, hasTikTok, hasInstagram, usBased, nonUS, country, hideRepeatApplicants, grades[], schools[], genders[], age{min,max}, earningsCents{min,max}, views{min,max}, posts{min,max}, rating{min}, reviews{min}, certificationTypes[], minCertifications, achievementKeys[], achievementMinTierByKey, minUnlockedAchievements, locations[], niches[], countries[], trainingProgress{min,max}, xp{min,max}, minRank).

lastDoc
string

Optional raw doc-id cursor as a JSON-encoded string ({lastDocId}); alternative to the standard cursor.

Response

Cursor page of enriched applicants with advanced profile-dependent filtering applied.

nextCursor
string | null
required
hasMore
boolean
required
data
object[]
required
lastDocId
string | null

Raw Firestore doc-id cursor of the last scanned applicant (also wrapped into nextCursor).

filters
object

Echo of the filters that were applied.