GET approval_requests/list
Available from CRM.COM R9.0.0
Deprecated from CRM.COM R18.0.0
This method returns information related to approval requests having specific attributes. Multiple approval requests are returned by each call.
Resource URL
Parameters
Name | Type | Description | ||||||||||||
token | String | The token retrieved from the login method | ||||||||||||
authorised_user_identifier (semi-optional) | User Identifier | The identifier of the authorised user related with the approval requests that should be returned as a result. The allowed user identifier fields are the following:
| ||||||||||||
approval_definition_identifier (semi-optional) | Approval Definition Identifier | The identifier of the approval definition related to the approval requests that should be returned as a result. The allowed approval definition identifier fields are the following:
| ||||||||||||
workflow_rule_identifier (semi-optional) | Workflow Rule Identifier | The identifier of the workflow rule that triggered the approval requests that should be returned as a result. The allowed workflow rule identifier fields are the following:
| ||||||||||||
entity (semi-optional) | String | The name of the entity related to the approval requests that should be returned as a result. The supported entities are the following:
| ||||||||||||
entity_id (semi-optional) | String | The ID of the entity related to the approval requests that should be returned as a result | ||||||||||||
responded_by_user_identifier (optional) | User Identifier | The identifier of the responded by the user related with the approval requests that should be returned as a result. The allowed user identifier fields are the following:
| ||||||||||||
unified_code (optional) | String | The unified code of the approval requests that should be returned as a result | ||||||||||||
life_cycle_state (optional) | String | The life cycle state of the approval requests that should be returned as a result. The supported options are PENDING, ACCEPTED, REJECTED or CANCELLED | ||||||||||||
created_date (optional) | Date | The created date of the approval requests that should be returned as a result. | ||||||||||||
response_date (optional) | Date | The response date of the approval requests that should be returned as a result. | ||||||||||||
number_of_results (optional) | Number | The number of results that can be retrieved through each call Available from CRM.COM R13.0.0 | ||||||||||||
offset (optional) | Number | Defines the number of entities that should be skipped from the results. If it is set to 0 then none results should be skipped, otherwise, the results will begin from the provided offset number Available from CRM.COM R13.0.0 | ||||||||||||
fields_set | 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 |
Restrictions
- It is mandatory to specify at least one of the semi-optional parameters. Multiple of those parameters are allowed to be specified.
Response Data
Name | Type | Description |
---|---|---|
id | String | The ID of the retrieved approval request |
number | String | The number of the retrieved approval request |
unified_code | String | The unified code of the retrieved approval request |
life_cycle_state | String | The life cycle state of the retrieved approval request which can be PENDING, APPROVED, REJECTED or CANCELLED |
entity | String | The name of the entity related with the approval request. The supported entities are the following:
|
entity_id | String | The ID of the entity related to the approval request |
subject | String | The subject of the retrieved approval request |
response | String | The response of the retrieved approval request |
response_date | Date | The date that a response was provided for the retrieved approval request |
responded_by | User Object | The user that responded to the retrieved approval request |
approval_definition | Approval Definition Object | The approval definition that was used to create the approval request |
workflow_rule | Workflow Rule Object | The workflow rule that triggered the approval request |
authorised_users_set | Set of Users Objects | The users that are authorised to approve, reject or cancel the approval request |
log_information | Log Information Object | The log information of the retrieved approval request |
Referred Objects Response Data