Skip to main content

Get Counterparty Types List using Admin Privilege

Purpose

To get the counterparty types list maintained in Choice Lists using the Admin privilege.

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

 Zoho Contracts Developer Community