Get Professional Candidates

GET

/professionals/candidates

Allows a professional to retrieve a list of all posting candidates they have submitted.

Authorizations

• ApiKeyAuth

Parameters

Query Parameters

category

required

string

Allowed values: active archived

Filter candidates by category

status

string

Filter by professional status within category. For active: applied, scheduled, interviewed. For archived: hired, closed

page

integer

Page number (default: 1)

pageSize

integer

Page size (default: 15)

Responses

200

Successfully retrieved candidates

object

data

Array<object>

object

appliedAt

string

createdAt

string

createdBy

string

hiringStatus

string

Allowed values: under_review hired not_selected

id

string

isShortlisted

boolean

officeStatus

string

Allowed values: applied scheduled interviewed cancelled hired rejected

onsiteInterviewId

string

postingDetails

object

id

string

officeId

string

officeName

string

postingTitle

string

professionType

string

salaryRange

object

max

integer

min

integer

payType

string

Allowed values: Salary Hourly Daily

yearly

integer

schedule

object

expectedDays

Array<integer>

type

string

Allowed values: Full Time Part Time Flexible

specialty

string

state

string

status

string

Allowed values: draft active paused closed suspended

subProfession

string

postingId

string

professionalEmail

string

professionalId

string

professionalName

string

professionalPhone

string

professionalStatus

string

Allowed values: applied scheduled interviewed hired closed

professionalStatusUpdatedAt

string

resumeId

string

updatedAt

string

updatedBy

string

pagination

object

page

integer

pageSize

integer

total

integer

400

Bad Request (e.g., invalid or missing category filter)

object

error

string

401

Unauthorized (API key missing or invalid)

object

error

string

403

Forbidden (Professional ID not found in token)

object

error

string

500

Internal Server Error (e.g., database error, service failure)

object

error

string