Get Pending Obligations List
Purpose
To get the list of all the pending obligations owned by the user.
Request Details
Request URL
https://contracts.zoho.com/api/v1/pendingobligations?direction=desc&sortBy=dueDate
Authorization
Authorization: Zoho-oauthtoken 1000.67013ab3960787bcf3affae67e649fc0.83a789c859e040bf11e7d05f9c8b5ef6
Scope
contracts.contracts.READ, contracts.contracts.ALL
Possible Operation Types
ALL - Full access to pending obligations
READ - Get pending obligations
Sample Request
Copiedcurl "https://contracts.zoho.com/api/v1/pendingobligations?direction=desc&sortBy=dueDate"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.67013ab3960787bcf3affae67e649fc0.83a789c859e040bf11e7d05f9c8b5ef6"Response JSON Keys
- modifiedTimestring
Represents the time of modification.
- apiNamestring
Represents the name of the obligation in the API.
- taskOwnersJSON Object
Represents the ID of the obligation's owner.
- instancesJSON Array
Represents details of each instance of a recurring obligation.
- sequenceNumberinteger
Represents the ordinal number of an instance of a recurring obligation.
- isOverDueboolean
Represents whether the obligation task is overdue or not.
Value Description True The obligation's task is overdue. False The obligation's task is not overdue.
- isCurrentboolean
Represents whether the obligation is currently being worked on or not.
Value Description True The obligation is currently being worked on. False The obligation is not currently being worked on.
- dueOnstring
Represents the due date of the obligation task.
- idstring
Represents the ID of the particular obligation task instance.
- actionsJSON Object
Represents the history of status changes of each instance in an obligation.
- createdOnstring
Represents the date on which the obligation is created.
- usersJSON Object
Represents the task owners of the obligation.
- statusinteger
Represents the current status of the instance.
Value Description 11 Not Started 12 In Progress 14 Completed
- recurringJSON Array
Represents whether the obligation's task is of a recurring type.
- dueOnTerminationboolean
Represents whether the recurring obligation ends with contract expiry or termination.
Value Description True The recurring obligation ends with contract expiry or termination. False The recurring obligation does not end with contract expiry or termination.
- timePeriodinteger
Represents whether the recurring obligation is due for days, weeks, months or years of period in time.
Value Description 0 Days 1 Weeks 2 Months 3 Years
- startDateStringstring
Represents the start date in dd/mm/yyyy format which gets returned when retrieving the obligation information.
- startsOninteger
Represents whether the start date of the recurring obligation's first instance is on a specific date or on the contract effective date.
Value Description 1 Specific Date 2 On Effective Date
- startDatestring
Represents the start date in javascript milliseconds format.
- frequencyinteger
Represents the time interval in terms of the number of days, weeks, months, or year an obligation task instance is executed.
- contractJSON Array
Represents the details of the contract.
- ownerJSON Object
Represents the name of the contract owner.
- apiNamestring
Represents the name of the contract in the API.
- systemStatusnumber
Represents the status of the contract.
Value Description 12 In Progress 1 Active 9 Terminated 10 Expired 7 On Hold 3 Termination Initiated
- isActivenumber
Represents whether the contract is active.
Value Description 1 Active 0 Deleted 5 Archived
- intentnumber
Represents the intent of the contract.
Value Description 0 Others 1 Buy 2 Sell
- partyAnumber
Represents the contracting party in a contract.
Value Description 0 My Company 1 Counterparty
- partyBnumber
Represents the contracting party in a contract.
Value Description 0 My Company 1 Counterparty
- namestring
Represents the name of the contract.
- descriptionstring
Represents the description of the obligation.
- priorityinteger
Represents the priority of the obligation.
Value Description 0 Low 1 Medium 2 High
- hasTaskboolean
Represents whether the obligation is a task or not.
Value Description True The obligation is a task. False The obligation is not a task.
- namestring
Represents the name of the obligation.
- addedTimestring
Represents the time the obligation is added.
- categoryJSON Object
Represents the category the obligation falls under.
- statusinteger
Represents the status of an obligation.
Value Description 0 Deleted 1 Active 13 Paused 14 Completed 16 Yet to start 17 Scheduled
Possible Errors
INVALID_URL_PATTERNHTTP 404
Request URL is incorrect
Resolution: Specify a valid request URL. Refer to the Request URL section above.
OAUTH_SCOPE_MISMATCHHTTP 401
Unauthorized
Resolution: Client does not have contracts.contracts.READ scope. Create a new client with valid scope. Refer to the Scope section above.
NO_PERMISSIONHTTP 403
Permission denied to read
Resolution: The user does not have permission to read records. Contact your organization administrator.
INTERNAL_ERRORHTTP 500
Internal Server Error
Resolution: Unexpected and unhandled exception in the server.
INVALID_REQUEST_METHODHTTP 400
The HTTP request method is not a valid one.
Resolution: You have specified an invalid HTTP method to access the API URL. Specify a valid request method. Refer to the Endpoints section above.
AUTHORIZATION_FAILEDHTTP 400
The user does not have sufficient privilege to read module details.
Resolution: The user does not have permission to retrieve module details. Contact your organization administrator.
Sample Response
Copied{
"Obligation": [
{
"modifiedTime": String,
"apiName": String,
"taskOwners": [
{
"displayName": String,
"id": String
}
],
"instances": [
{
"sequenceNumber": 14,
"isOverDue": Boolean,
"isCurrent": Boolean,
"dueOn": String,
"id": String,
"actions": [],
"createdOn": String,
"users": [
{
"displayName": "Mohanesh",
"id": String
}
],
"status": Number
}
],
"recurring": {
"dueOnTermination": boolean,
"timePeriod": Number,
"exclude": [
Number
],
"startDateString": String,
"startsOn": Number,
"startDate": String,
"frequency": Number
},
"contract": {
"owner": {
"displayName": String,
"emailId": String,
"id": String
},
"partyA": Number,
"apiName": String,
"systemStatus": Number,
"partyB": Number,
"name": "Specific Date",
"isActive": Number,
"intent": Number
},
"description": String,
"priority": Number,
"hasTask": Boolean,
"name": String,
"addedTime": String,
"category": {
"apiName": String,
"displayName": String
},
"status": Number
}
]
}
LEGEND
PRIORITY
LOW - 0
MEDIUM - 1
HIGH - 2
STATUS
DELETED - 0
ACTIVE - 1
PAUSED - 13
COMPLETED - 14
YET TO START - 16
SCHEDULED - 17
INSTANCE_STATUS
NOT_STARTED - 11
IN PROGRESS - 12
COMPLETED - 14
TIME_PERIOD
DAYS - 0
WEEKS - 1
MONTHS - 2
YEARS - 3
STARTS_ON
SPECIFIC DATE - 1
ON EFFECTIVE DATE -2
partyA
MY_COMPANY - 0
COUNTERPARTY - 1
systemstatus
IN_PROGRESS - 12
ACTIVE - 1
TERMINATED - 9
EXPIRED - 10
ON_HOLD - 7
TERMINATION_INITIATED - 3
partyB
MY_COMPANY - 0
COUNTERPARTY - 1
isActive
ACTIVE - 1
DELETED - 0
ARCHIVED - 5
intent
OTHERS - 0
BUY - 1
SELL - 2