Retrieve a job category
Returns a single job category record by its internal ID.
Tip
Check the Swagger page for more technical information on the endpoints.
Endpoint details
GET
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/job-categories/{jobCategoryReference}
Headers: Authorization: Bearer {token}, User-Agent: {agent}
Scope: connector-protimeapi-job-categories.read
URL parameters
| Parameter | Description |
|---|---|
{jobCategoryReference} |
The internal ID or external reference of the job category. |
Response properties
| Field | Type | Required | Writable | Description |
|---|---|---|---|---|
changeVersion |
string | — | Read-only | Property to indicate the order of changes. |
id |
integer | — | Read-only | Unique identifier for the job category. |
name.default |
string | — | Read-only | Default name of the job category. |
name.translations |
object | — | Read-only | Translated names for supported languages. |
externalCode |
string | — | Read-only | External code for the job category. |
External references
The endpoint supports custom external references. See the external references page for details.
Error responses
| Status | Condition |
|---|---|
400 |
Invalid external reference specification (e.g., unsupported predefined reference or non-integer ID without external reference) |
401 |
Missing or invalid access token, or insufficient scope |
404 |
Job category with the given ID or external reference not found |
Examples
Retrieve a job category
Example retrieving a job category with internal ID 456:
GET
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/job-categories/456
Retrieve a job category with a custom external reference
Example retrieving a job category with a custom external code 1795:
GET
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/job-categories/1795?externalReferences=(job-categories,CustomReferenceName)