API Reference

List a candidate’s notes

get
https://api.join.com/v3/candidates//notes

Returns a candidate’s notes with their replies attached, sorted by creation date (oldest first). Your token reads every note of your company, private or not — isPrivate governs visibility between recruiters in the product, not API access.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required

Id of the candidate

Query Params
integer
1 to 50
Defaults to 10

Number of records to return

string

Position from the previous response's nextCursor. Omit on the first request

Headers
string

Selects the dated API version the request runs against, named after its release day as YYYY-MM-DD, e.g. 2026-11-01. Omit to use the current default version (2026-11-01). A value that is not a supported version is rejected with 400 unsupported_api_version.

Responses

Updated 23 days ago

Did this page help you?
Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 23 days ago

Did this page help you?