Skip to content
API reference
/
/
Read a job title

Read a job title

Request

Returns one role with its description and the training assigned to whoever takes it on. relations.functional_area carries the parent group in full, so a separate call is not needed to see which group the role belongs to.

The role must belong to the functional area named in the URL; asking for one under a different group is not found.

Security
default
Path
functionalarea_idintegerrequired

The ID of the functional area.

idintegerrequired

The ID of the job title.

Headers
Rosterfy-Platformstring
curl -i -X GET \
  'https://developer.rosterfy.com/_mock/api-docs/openapi/api/v2/headcount/functionalarea/{functionalarea_id}/jobtitle/{id}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Rosterfy-Platform: admin'

Responses

Bodyapplication/json
objectobject
niceobject
relationsobject
permissionsobject
Response
{
  "object": {
    "id": 1,
    "headcount_functional_area_id": 1,
    "name": "Information Desk Attendant",
    "frontend_name": "Information Desk Attendant",
    "code": "INFODESK",
    "description": "<p>Answers visitor questions at the information desk.</p>",
    "training_ids": [ … ],
    "deleted_at": null,
    "created_at": "2026-06-09T05:36:16.000000Z",
    "updated_at": "2026-06-09T05:36:16.000000Z",
    "uuid": "e17404de-d3db-4e85-81ee-4552d19da8c4"
  },
  "nice": {
    "rrn": "rrn:local:20101:job_title:1",
    "functional_area_name": "Guest Services"
  },
  "relations": {
    "functional_area": { … }
  },
  "permissions": {
    "read": true,
    "update": true,
    "delete": true
  }
}