Available from CRM.COM R9.0.0
GET service_requests/configuration/types/list
This method returns the service request types that are allowed to be used in the system as these are defined in active Service Request Definitions. Multiple service request types are returned by each call.
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
group_identifier (optional) | Group Identifier | The identifier of the group that will be providing the service request type. The group is filtered against the service request types' allowed organisational units. The allowed group identifier fields are the following:
| ||||||||||||
unit_identifier (optional) | Unit Identifier | The identifier of the unit that will be providing the service request type. The unit is filtered against the service request types' allowed organisational units. The allowed unit identifier fields are the following:
| ||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved service request type |
name | String | The name of the retrieved service request type |
alternative_code | String | The alternative code of the retrieved service request type |
description | String | A description of the retrieved service request type |
udf_string_1 | String | User Defined Field of type String |
udf_string_2 | String | User Defined Field of type String |
udf_string_3 | String | User Defined Field of type String |
udf_string_4 | String | User Defined Field of type String |
udf_string_5 | String | User Defined Field of type String |
udf_string_6 | String | User Defined Field of type String |
udf_string_7 | String | User Defined Field of type String |
udf_string_8 | String | User Defined Field of type String |
udf_float_1 | Float | User Defined Field of type Float |
udf_float_2 | Float | User Defined Field of type Float |
udf_float_3 | Float | User Defined Field of type Float |
udf_float_4 | Float | User Defined Field of type Float |
udf_date_1 | Date | User Defined Field of type Date |
udf_date_2 | Date | User Defined Field of type Date |
udf_date_3 | Date | User Defined Field of type Date |
udf_date_4 | Date | User Defined Field of type Date |
estimated_completion_time | Time Period Object | The time that is estimated to be required in order complete service requests of this type, measured in minutes, hours, days, weeks, years |
log_information | Log Information Object | The log information of the retrieved service request type |
Referred Objects Response Data
Examples
GET service_requests/configuration/statuses/list
This method returns the statuses that are allowed to be used by service requests of specific type. Multiple statuses are returned by each call
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
service_request_type_identifier (mandatory) | Service Request Type Identifier | The identifier of the type of the service request that will be using the statuses. The statuses are filtered against the allowed statuses of the specified type. The allowed service request type identifier fields are the following:
| ||||||||||||
life_cycle_state (optional) | Sting | The life cycle state that the status should have. If specified then only statuses related with the specified life cycle state will be retrieved. Life cycle state options are: PENDING, RESPONDED, TEMPORARY RESOLVED, FINAL RESOLVED and COMPLETED | ||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved service request type status |
default | Boolean | Determines if the service request type status is the default status or not |
status | Service Request Status Object | The actual status provided by the service request type status |
Referred Objects Response Data
Examples
GET service_requests/configuration/categories/list
This method returns the service request categories that are allowed to be used by service requests of a specific type. Multiple service request categories are returned by each call
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
service_request_type_identifier (mandatory) | Service Request Type Identifier | The identifier of the type of the service request that will be using the categories. The categories are filtered against the allowed categories of the specified type. The allowed service request type identifier fields are the following:
| ||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved service request type category |
default | Boolean | Determines if the service request type category is the default category in the service request type or not |
category | Service Request Category Object | The actual category provided by the service request type category |
Referred Objects Response Data
Examples
GET service_requests/configuration/response_categories/list
This method returns the service request response categories that are allowed to be used by service requests of a specific type. Multiple service request response categories are returned by each call
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
service_request_type_identifier (mandatory) | Service Request Type Identifier | The identifier of the type of the service request that will be using the response categories. The response categories are filtered against the allowed response categories of the specified type. The allowed service request type identifier fields are the following:
| ||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved service request type response category |
default | Boolean | Determines if the service request type response category is the default response category in the service request type or not |
category | Service Request Response Category Object | The actual response category provided by the service request type category |
Referred Objects Response Data
Examples
GET service_requests/configuration/temporary_resolution_categories/list
This method returns the service request temporary resolution categories that are allowed to be used by service requests of a specific type. Multiple service request temporary resolution categories are returned by each call
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
service_request_type_identifier (mandatory) | Service Request Type Identifier | The identifier of the type of the service request that will be using the temporary resolution categories. The temporary resolution categories are filtered against the allowed temporary resolution categories of the specified type. The allowed service request type identifier fields are the following:
| ||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved service request type temporary resolution category |
default | Boolean | Determines if the service request type temporary resolution category is the default temporary resolution category in the service request type or not |
category | Service Request Temporary Resolution Category Object | The actual temporary resolution category provided by the service request type temporary resolution category |
Referred Objects Response Data
Examples
GET service_requests/configuration/final_resolution_categories/list
This method returns the service request final resolution categories that are allowed to be used by service requests of a specific type. Multiple service request final resolution categories are returned by each call
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
service_request_type_identifier (mandatory) | Service Request Type Identifier | The identifier of the type of the service request that will be using the final resolution categories. The final resolution categories are filtered against the allowed final resolution categories of the specified type. The allowed service request type identifier fields are the following:
| ||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved service request type final resolution category |
default | Boolean | Determines if the service request type final resolution category is the default final resolution category in the service request type or not |
category | Service Request Final Resolution Category Object | The actual final resolution category provided by the service request type final resolution category |
Referred Objects Response Data
Examples
GET service_requests/configuration/physical_goods/list
This method returns the physical goods that are allowed to be used by service requests of specific type. Multiple physical goods are returned by each call
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
service_request_type_identifier (mandatory) | Service Request Type Identifier | The identifier of the type of the service request that will be using the physical goods. The physical goods are filtered against the allowed physical goods of the specified type. The allowed service request type identifier fields are the following:
| ||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved service request type physical good |
Product Object | The actual product provided by the service request type physical good | |
product_type | Product Type Object | The actual product type provided by the service request type physical good |
Referred Objects Response Data
Examples
GET service_requests/configuration/services/list
This method returns the services that are allowed to be used by service requests of specific type. Multiple services are returned by each call
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
service_request_type_identifier (mandatory) | Service Request Type Identifier | The identifier of the type of the service request that will be using the services. The services are filtered against the allowed services of the specified type. The allowed service request type identifier fields are the following:
| ||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved service request type service |
Product Object | The actual product provided by the service request type service | |
product_type | Product Type Object | The actual product type provided by the service request type service |
Referred Objects Response Data
Examples
GET service_requests/configuration/activity_types/list
This method returns the activity types that are allowed to be used by service requests of specific type. Multiple activity types are returned by each call
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
service_request_type_identifier (mandatory) | Service Request Type Identifier | The identifier of the type of the service request that will be using the activity types. The activity types are filtered against the allowed activity types of the specified type. The allowed service request type identifier fields are the following:
| ||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved service request type activity type |
activity_type | Activity Type Object | The actual activity type provided by the service request type activity type |
Referred Objects Response Data
Examples
GET service_requests/configuration/job_types/list
This method returns the job types that are allowed to be used by service requests of specific type. Multiple job types are returned by each call
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
service_request_type_identifier (mandatory) | Service Request Type Identifier | The identifier of the type of the service request that will be using the job types. The job types are filtered against the allowed job types of the specified type. The allowed service request type identifier fields are the following:
| ||||||||||||
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved service request type job type |
job_type | Activity Type Object | The actual job type provided by the service request type job type |
Referred Objects Response Data
Examples
GET service_requests/configuration/impact_levels/list
This method returns the impact levels that are allowed to be used by service requests of any type. Only impact levels defined in the active Service Request Definitions and set as Supported are retrieved. Multiple impact levels are returned by each call
Resource URL
Parameters
Name | Type | Description |
token | String | The token retrieved from the login method |
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved service request impact level |
name | String | The name of the retrieved service request impact level |
label | String | The label of the retrieved service request impact level |
default | Boolean | Determines if the service request impact level is the default impact level or not |
Examples
GET service_requests/configuration/urgency_levels/list
This method returns the urgency levels that are allowed to be used by service requests of any type. Only urgency levels defined in the active Service Request Definitions and set as Supported are retrieved. Multiple urgency levels are returned by each call
Resource URL
Parameters
Name | Type | Description |
token | String | The token retrieved from the login method |
fields_set (optional) | List of Strings, comma separated | A list of fields that should be included in the results. If not specified then all the available fields will be returned |
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved service request urgency level |
name | String | The name of the retrieved service request urgency level |
label | String | The label of the retrieved service request urgency level |
default | Boolean | Determines if the service request urgency level is the default urgency level or not |