Enumerations API
The R-Service fields in which one option can be selected form a fixed list of values are called enumerations. The Enumerations API provides an easy way to view all enumerations defined by the system.
List enumerations
The enumerations are available in a few formats:
- JSON - https://api.r-service.tech/v1/enums (default)
- HTML - https://api.r-service.tech/v1/enums.html
- CSV - https://api.r-service.tech/v1/enums.csv
And in several languages (see also internationalization), examples include:
- English - https://api.r-service.tech/v1/enums.html (default)
- French - https://api.r-service.tech/v1/enums/fr.html
- Danish - https://api.r-service.tech/v1/enums/da.html
By default all enumerations in the R-Service application are retrieved in the locale of the API user:
GET /enums
Response
Status: 200 OK
{
"request.status": [
{
"id": "declined",
"txt": "Declined"
},
{
"id": "assigned",
"txt": "Assigned"
},
{
"id": "accepted",
"txt": "Accepted"
},
"..."
],
"task.category": [
{
"id": "risk_and_impact",
"txt": "Risk & Impact"
},
{
"id": "approval",
"txt": "Approval"
},
{
"id": "implementation",
"txt": "Implementation"
}
],
"language": [
"..."
]
}