List roles

GET

https://api.sureshake.com/v2/hiring/roles

Query parameters

entityId
optional
string
format: uuid

q
optional
string
maxLength: 255 · minLength: 1
location
optional
string
maxLength: 255 · minLength: 1
remotePolicy
optional
remote
or
hybrid
or
onsite
status
optional
draft
or
published
or
closed
visibility
optional
public
or
unlisted
or
private
limit
optional
integer
maximum: 100 · minimum: 1 · default: 20
offset
optional
integer
minimum: 0 · default: 0

Returns

200

Default Response

JSON

data
array of
object
required
- id
  string
  required
  format: uuid
- entityId
  string
  required
  format: uuid
- title
  string
  required
- description
  string
  or null
  required
- location
  string
  or null
  required
- remotePolicy
  remote
  or
  hybrid
  or
  onsite
  or null
  required
- salaryRange
  object
  or null
  required
  min
  optional
  number
  max
  optional
  number
  currency
  optional
  string
  period
  optional
  hourly
  or
  monthly
  or
  yearly
- status
  draft
  or
  published
  or
  closed
  required
- visibility
  public
  or
  unlisted
  or
  private
  required
- publishedAt
  string
  or null
  required
  format: date-time
- closesAt
  string
  or null
  required
  format: date-time
- createdAt
  string
  required
  format: date-time
- updatedAt
  string
  required
  format: date-time
- problemSpecs
  optional
  array of
  object
  id
  string
  required
  prompt
  string
  required
  orderIndex
  number
  required
  successCriteria
  optional
  string
- rubric
  optional
  object
  or null
  version
  number
  required
  dimensions
  array of
  object
  required
  id
  string
  required
  name
  string
  required
  weight
  number
  required
  scaleMin
  number
  required
  scaleMax
  number
  required
  description
  optional
  string
  createdAt
  optional
  string
- entity
  optional
  object
  id
  string
  required
  format: uuid
  name
  string
  required
  slug
  string
  required
  logoUrl
  string
  or null
  required
  verified
  boolean
  required
}
meta
object
required
- total
  number
  required
  Total number of items available
- limit
  number
  required
  Number of items per page
- offset
  number
  required
  Number of items skipped
- hasMore
  boolean
  required
  Whether more items are available
- page
  optional
  number
  Current page number
- totalPages
  optional
  number
  Total number of pages
}

400

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

401

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

403

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

404

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

409

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

500

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}

503

Default Response

JSON

error
object
required
- code
  string
  required
  Machine-readable error code (e.g., NOT_FOUND)
- message
  string
  required
  Human-readable error message
- details
  optional
  unknown
  Optional structured error details
- traceId
  optional
  string
  Unique ID for log correlation
}