Retrieve a sector
Introduction
You can retrieve a sector by the internal ID or an external reference using the GET call.
Tip
Check the Swagger page for more technical information on the endpoints.
Endpoint details
GET
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/sectors/{sectorReference}
URL parameters
This parameter needs to be filled in when calling this endpoint.
| Parameter | Description |
|---|---|
<sectorReference> |
The internal ID or external reference of the sector. |
Response properties
This list of properties is returned by this endpoint.
| Property | Type | Description |
|---|---|---|
changeVersion |
string | Property to indicate the order of changes. |
id |
integer | Unique identifier for the sector. |
name.default |
string | Default name of the sector. |
name.translations |
object | Translated names for supported languages. |
External references
It’s possible to use custom external references as a sectorReference to retrieve a sector. More information can be found on the External References Page
Note
Check the query options below the endpoint on the Swagger page for the relevant external references.
Examples
Retrieve one sector
Example retrieving one sector with internal ID 456:
GET
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/sectors/456
Retrieve a sector with a custom external reference
Example retrieving a sector with a custom external code FD789:
GET
https://<tenant>.myprotime.eu/connector/protimeapi/api/v1/sectors/FD789?externalReferences=(sectors,CustomReferenceName)