Get candidate by professional ID

GET

/candidates/professionals/{professionalId}

Get candidate information for a professional on a specific posting

Authorizations

• ApiKeyAuth

Parameters

Path Parameters

professionalId

required

string

Professional ID (24-char hex)

Query Parameters

postingId

required

string

Posting ID (UUID)

Responses

200

Successfully retrieved the candidate

object

data

object

appliedAt

string

createdAt

string

createdBy

string

deletedAt

string

deletedBy

string

hiringStatus

string

Allowed values: under_review hired not_selected

id

string

isDeleted

boolean

isShortlisted

boolean

officeStatus

string

Allowed values: applied scheduled interviewed cancelled hired rejected

onsiteInterviewId

string

postingDetails

object

benefits

Optional

Array<string>

benefitsOther

Optional, can be empty

string

closedAt

string

closedBy

string

createdAt

string

createdBy

string

expectedDays

Optional

Array<integer>

id

string

maxRate

Optional, can be empty

integer

minRate

integer

officeId

string

officeName

string

officeSpecialty

string

payType

string

Allowed values: Salary Hourly Daily

postingDescription

string

postingTitle

string

professionType

string

recruiterEmail

Optional, can be empty

string

scheduleType

string

Allowed values: Full Time Part Time Flexible

state

From office at the time of posting creation

string

status

string

Allowed values: draft active paused closed suspended

subProfession

Optional, can be empty

string

timezone

string

updatedAt

string

updatedBy

string

postingId

string

professionalEmail

string

professionalId

string

professionalName

string

professionalPhone

string

professionalStatus

string

Allowed values: applied scheduled interviewed hired closed

updatedAt

string

updatedBy

string

400

Bad request (e.g., invalid professionalId or missing postingId)

object

error

string

401

Unauthorized

object

error

string

403

Forbidden (office does not own the posting)

object

error

string

404

Not Found (candidate not found)

object

error

string

500

Internal Server Error

object

error

string