Skip to main content
GET
List an agency member's approved roles

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

recruiterEmail
string<email>
required

Email of currently approved member of your agency, e.g. jane@agency.com. Results use that member's permissions; does not authenticate key holder. Unknown, other-agency, or unapproved member answers 403.

Maximum string length: 254
query
string

Matched against role titles and company names in member's approved roles, e.g. backend engineer. 1-200 characters.

Required string length: 1 - 200
primaryOnly

Only roles where member holds approved primary slot. Default false.

Available options:
true,
false
activeTrialOnly

Only primary slots with trial still in progress. Default false. Trial ends when window closes or submission goal met.

Available options:
true,
false
singleSubmissionsOnly

Only roles where member has active single submission (submitted, reviewed, interviewing, offer). Default false. Includes roles whose approval since withdrawn.

Available options:
true,
false
paraAiOnly

Only roles where member has active submission (submitted, reviewed, interviewing, offer) from ParaAI match. Default false. Includes roles whose approval since withdrawn.

Available options:
true,
false
status
enum<string> | null
default:ACTIVE

ACTIVE (default), PAUSED, or CLOSED (includes hired, churned). Unrecognized value falls back to ACTIVE. Pending, rejected, disqualified roles never returned.

Available options:
ACTIVE,
PAUSED,
CLOSED
limit
integer
default:50

Roles per page, 1-100, default 50. Above 100 rejected with 400.

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

Previous page's nextCursor. Only with same recruiterEmail, query, status, filters; changed filter answers 400, so start new first page.

Required string length: 1 - 2048

Response

200 - application/json

Success

roles
object[]
required
nextCursor
string | null
required