The vote read endpoints let you load the community endorsement data that drives the career roadmap’s popularity signals. You can retrieve aggregated vote counts for every subject within a profession, look up which way a specific user voted on each subject in a profession, or pull the complete voting history for any user account.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/Daniel-Stojanovski/finkiopendesk/llms.txt
Use this file to discover all available pages before exploring further.
All endpoints on this page are public. No authentication token is required to read vote data.
GET /api/votes/pid/{professionId}
Returns the total vote count for each subject that belongs to the given profession. This is the primary call used to display how popular each recommended subject is within a career path.Path parameters
The unique identifier of the profession whose subject vote counts you want to retrieve.
Response
An array ofVotesCountProjection objects — one entry per subject that has received at least one vote within the profession.
Unique identifier of the subject the vote count applies to.
Net total of votes cast for this subject within the profession. Upvotes contribute
+1 and downvotes contribute -1 to the running sum, so this value can be negative.Example
GET /api/votes/pid/{professionId}/{userId}
Returns the individual vote value that a specific user has cast on each subject within a profession. Use this endpoint to restore a user’s prior voting state when they revisit the career roadmap.Path parameters
The unique identifier of the profession.
The UUID of the user whose votes you want to retrieve.
Response
An array ofUserVoteProjection objects — one entry per subject in the profession where the user has cast a vote. Subjects the user has not voted on are omitted.
Unique identifier of the subject the user voted on.
The value the user cast:
1 for an upvote or -1 for a downvote.Example
GET /api/votes/{userId}
Returns allVote records associated with the given user, spanning every profession they have voted in. This is a broader query than the profession-scoped endpoints above and returns full vote entity objects rather than projections.
Path parameters
The UUID of the user whose complete vote history you want to retrieve.
Response
An array ofVote objects. Returns an empty array if the user has not cast any votes.
UUID of this vote record, auto-generated by the server.
UUID of the user who cast the vote.
ID of the subject the vote was cast on.
ID of the profession context in which the vote was cast. A single subject can receive separate votes under different professions.
Vote value:
1 for an upvote or -1 for a downvote.