Hiring Endpoints

These endpoints power role discovery, applications, evaluations, and matching.

List Roles

Retrieve a paginated list of published hiring roles.

GET/api/v1/hiring/roles

curl -H "Authorization: Bearer $TOKEN" https://api.sureshake.com/api/v1/hiring/roles

const response = await fetch('https://api.sureshake.com/api/v1/hiring/roles', {
headers: { Authorization: `Bearer ${token}` },
});
const { data } = await response.json();

200 OK

{
"data": [
  {
    "id": "8f2349ef-22ab-46ae-a129-2eb4c2570001",
    "title": "Senior Financial Analyst",
    "entityId": "8f2349ef-22ab-46ae-a129-2eb4c2570002",
    "location": "Remote",
    "remotePolicy": "remote",
    "status": "published",
    "createdAt": "2024-01-10T10:00:00Z",
    "updatedAt": "2024-01-10T10:00:00Z"
  }
],
"meta": {
  "total": 1,
  "limit": 20,
  "offset": 0,
  "hasMore": false
}
}

Create Role

Create a new hiring role for an entity.

POST/api/v1/hiring/roles

curl -X POST \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"title": "Analyst", "entityId": "8f2349ef...", "remotePolicy": "hybrid"}' \
https://api.sureshake.com/api/v1/hiring/roles

Apply to Role

Submit an application for a specific role.

POST/api/v1/hiring/applications

curl -X POST \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"roleId": "8f2349ef..."}' \
https://api.sureshake.com/api/v1/hiring/applications

List My Applications

Retrieve applications submitted by the current user.

GET/api/v1/hiring/applications

curl -H "Authorization: Bearer $TOKEN" https://api.sureshake.com/api/v1/hiring/applications

List Roles

Create Role

Apply to Role

List My Applications

On this page