List all contracts
GET {{baseUrl}}/v1/contracts
To get a list of contracts
OAuth Scope
Desk.settings.READ
Request Params
Key | Datatype | Required | Description |
---|---|---|---|
from | string | From index | |
limit | string | Number of contracts to fetch | |
viewId | string | ID of the view to apply while fetching the resources | |
departmentId | string | ID of the department from which the contracts must be fetched | |
accountId | string | ID of the account associated with the contract | |
ownerId | string | ID of contract owner | |
sortBy | string | Parameter that sorts contracts by one of these attributes: <br>accountName ,<br> <br>contractName ,<br> <br>contractEndDate ,<br> <br>contractStartDate ,<br> <br>createdTime , or<br> <br>modifiedTime .<br> The default order of sorting is ascending. To sort in descending order, prefix a - with the parameter. | |
include | string | Allowed Value is: accounts |
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
Authorization | string |
RESPONSES
status: OK
{"data":[{"associatedSLAId":"10000000149109","accountId":"10000000265011","contractStatus":"FUTURE","productId":null,"endDate":"2018-11-10","departmentId":"10000000010762","contractName":"C2","id":"10000000270023","ownerId":"10000000012902","startDate":"2018-10-10"},{"associatedSLAId":"10000000149109","accountId":"10000000265011","contractStatus":"EXPIRED","productId":null,"endDate":"2018-09-10","departmentId":"10000000010762","contractName":"New","id":"10000000270045","ownerId":"10000000012902","startDate":"2018-09-09"},{"associatedSLAId":"10000000149109","accountId":"10000000272001","contractStatus":"ACTIVE","productId":null,"endDate":"2018-12-11","departmentId":"10000000010762","contractName":"THIRD","id":"10000000272013","ownerId":"10000000012902","startDate":"2018-09-11"},{"associatedSLAId":"10000000149109","accountId":"10000000272037","contractStatus":"ACTIVE","productId":null,"endDate":"2019-03-11","departmentId":"10000000010762","contractName":"Fourth ACC","id":"10000000272049","ownerId":"10000000012902","startDate":"2018-09-11"},{"associatedSLAId":"10000000149109","accountId":"10000000272071","contractStatus":"EXPIRED","productId":null,"endDate":"2018-09-12","departmentId":"10000000010762","contractName":"old","id":"10000000272083","ownerId":"10000000012902","startDate":"2017-09-11"},{"associatedSLAId":"10000000149109","accountId":"10000000265011","contractStatus":"ACTIVE","productId":null,"endDate":"2018-09-30","departmentId":"10000000010762","contractName":"FUTURE 1","id":"10000000273003","ownerId":"10000000012902","startDate":"2018-09-15"},{"associatedSLAId":"10000000149109","accountId":"10000000265011","contractStatus":"FUTURE","productId":null,"endDate":"2018-12-11","departmentId":"10000000010762","contractName":"FUTURE 3","id":"10000000273025","ownerId":"10000000012902","startDate":"2018-11-11"}]}