Get Counterparty Types List using Admin Privilege
Purpose
To get the counterparty types list maintained in Choice Lists using the Admin privilege.
Endpoints
Request Details
Request URL
https://contracts.zoho.com/api/v1/admin/counterpartytypes
Authorization
Authorization: Zoho-oauthtoken 1000.67013ab3960787bcf3affae67e649fc0.83a789c859e040bf11e7d05f9c8b5ef6
Scope
contracts.meta.READ, contracts.contracts.ALL
Possible Operation Types
ALL - Full access to counterparty types
READ - Get counterparty types
Sample Request
Copiedcurl "https://contracts.zoho.com/api/v1/admin/counterpartytypes"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.67013ab3960787bcf3affae67e649fc0.83a789c859e040bf11e7d05f9c8b5ef6"
Response JSON Keys
- modifiedTimestring
Represents the last modified time of the counterparty type.
- namestring
Represents the name of the counterparty type.
- idstring
Represents the unique ID of the counterparty type.
- addedByJSON Object
Represents the details of the user who created the counterparty type.
- apiNamestring
Represents the API name of the counterparty type.
- addedTimestring
Represents the time when the counterparty type was added.
- modifiedByJSON Object
Represents the details of the user who last modified the counterparty type.
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{
"counterpartytypes":[
{
"modifiedTime":"Jan 15, 2021 09:38 AM",
"apiName":"customer",
"addedBy":{
"displayName":"Smith Jones",
"emailId":"smith.jones@zylker.com",
"id":"596000000183025"
},
"name":"Customer",
"addedTime":"Jan 15, 2021 09:38 AM",
"modifiedBy":{
"displayName":"Smith Jones",
"emailId":"smith.jones@zylker.com",
"id":"596000000183025"
},
"id":"683000000008857"
},
{
"modifiedTime":"Jan 15, 2021 09:38 AM",
"apiName":"partner",
"addedBy":{
"displayName":"Smith Jones",
"emailId":"smith.jones@zylker.com",
"id":"596000000183025"
},
"name":"Partner",
"addedTime":"Jan 15, 2021 09:38 AM",
"modifiedBy":{
"displayName":"Smith Jones",
"emailId":"smith.jones@zylker.com",
"id":"596000000183025"
},
"id":"683000000008860"
},
{
"modifiedTime":"Jan 15, 2021 09:38 AM",
"apiName":"reseller",
"addedBy":{
"displayName":"Smith Jones",
"emailId":"smith.jones@zylker.com",
"id":"596000000183025"
},
"name":"Reseller",
"addedTime":"Jan 15, 2021 09:38 AM",
"modifiedBy":{
"displayName":"Smith Jones",
"emailId":"smith.jones@zylker.com",
"id":"596000000183025"
},
"id":"683000000008863"
},
{
"modifiedTime":"Jan 15, 2021 09:38 AM",
"apiName":"supplier",
"addedBy":{
"displayName":"Smith Jones",
"emailId":"smith.jones@zylker.com",
"id":"596000000183025"
},
"name":"Supplier",
"addedTime":"Jan 15, 2021 09:38 AM",
"modifiedBy":{
"displayName":"Smith Jones",
"emailId":"smith.jones@zylker.com",
"id":"596000000183025"
},
"id":"683000000008866"
},
{
"modifiedTime":"Jan 15, 2021 09:38 AM",
"apiName":"vendor",
"addedBy":{
"displayName":"Smith Jones",
"emailId":"smith.jones@zylker.com",
"id":"596000000183025"
},
"name":"Vendor",
"addedTime":"Jan 15, 2021 09:38 AM",
"modifiedBy":{
"displayName":"Smith Jones",
"emailId":"smith.jones@zylker.com",
"id":"596000000183025"
},
"id":"683000000008869"
},
{
"modifiedTime":"Jan 15, 2021 09:38 AM",
"apiName":"employee",
"addedBy":{
"displayName":"Smith Jones",
"emailId":"smith.jones@zylker.com",
"id":"596000000183025"
},
"name":"Employee",
"addedTime":"Jan 15, 2021 09:38 AM",
"modifiedBy":{
"displayName":"Smith Jones",
"emailId":"smith.jones@zylker.com",
"id":"596000000183025"
},
"id":"683000000112075"
}
]
}
Show full
Show less