Retrieve computers pending approval

Open in ChatGPT Open in ChatGPT to ask questions about this page
Open in Claude Open in Claude to ask questions about this page
Copy as MarkdownCopy this page as markdown to use with AI assistants
View as Markdown Open this page as markdown in a new tab

Retrieves computers pending approval or with a specific approval status. Used in the computer approval workflow. Supports filtering by approval status and computer name.

Request URL

https://{serverurl}/dcapi/som/approval/computers-info

Scope

DesktopCentralCloud.SOM.READCopied!

Header

Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52

Request Parameters

- Request Headers

AcceptstringMandatory
application/approvalComputersRes.v1+jsonapplication/approvalComputersRes.v1+jsonCopied!

- Query Parameters

pagestringOptional

Specifies the page number to retrieve. Default is 1

limitstringOptional

Specifies the number of records per page. Default is 25 and maximum is 500

approvalStatusstringOptional

Specifies the approval status code to filter by: 3=pending (default: 3)

computerNamestringOptional

Specifies the computer name to filter approval computers

Sample Request

Curl
Java
Python
Deluge
PowerShell
Copied!
curl --request GET \
  --url https://appdomains/dcapi/som/approval/computers-info \
  --header 'Accept: application/approvalComputersRes.v1+json' \
  --header 'Authorization: Zoho-oauthtoken  d92d4xxxxxxxxxxxxx15f52'

Response Parameters

- HTTP code 200

Response Body - application/json
JSON Object
Hide Sub-Attributes
totalstring

Total number of computer records matching the specified filter criteria across all pages

computerInfoJSON Array

Array of computer information objects for the current page, each containing details about the computer's approval status, network configuration, and domain membership

Show Sub-Attributes
JSON Object
Show Sub-Attributes
approvalStatusstring

Approval status code: 1 = approved, 2 = denied, 3 = pending approval

resourceIDstring

Unique resource identifier of the computer in the system

servicePackstring

Operating system service pack version. Returns '--' if unavailable

fqdnstring

Fully qualified domain name of the computer (e.g., 'PC01.corp.example.com'). Returns '--' if unavailable

ipAddressstring

IPv4 address of the computer. Returns '--' if unavailable

dbUpdatedTimestring

Timestamp in epoch milliseconds of when the computer record was last updated in the database

computerFullNamestring

Full display name of the computer including domain prefix (e.g., 'DOMAIN\PC01')

osNamestring

Full operating system name (e.g., 'Windows 11 Enterprise'). Returns '--' if unavailable

subnetMaskstring

Subnet mask of the computer's network interface. Returns '--' if unavailable

uuIdstring

Universally unique identifier (UUID) of the computer hardware. Returns '--' if unavailable

customerNamestring

Name of the customer or tenant this computer belongs to

macAddressstring

MAC address of the computer's primary network interface. Returns '--' if unavailable

osVersionstring

Operating system version number. Returns '--' if unavailable

computerNamestring

NetBIOS or hostname of the computer (e.g., 'PC01')

dbAddedTimestring

Timestamp in epoch milliseconds of when the computer was first added to the database

domainNamestring

Name of the Active Directory domain or workgroup the computer belongs to

guidstring

Globally unique identifier (GUID) of the computer object. Returns '--' if unavailable

remoteOfficeNamestring

Name of the remote office this computer is assigned to

remoteIpAddrstring

Remote/external IP address of the computer as seen by the server

pagestring

Current page number in the paginated result set (1-based)

- HTTP code 401

Response Body - application/json
JSON Object
Hide Sub-Attributes
errorCodelong

Unauthorized error code: credentials missing, expired, or invalid

errorMsgstring

Authentication failure reason

Possible Response Codes

200HTTP code
401HTTP code

Sample Response: HTTP 200

Computers pending approval

Copied!
  {
    "total": 30,
    "computerInfo": [
      {
        "approvalStatus": 3,
        "resourceID": "3009",
        "servicePack": "--",
        "fqdn": "--",
        "ipAddress": "--",
        "dbUpdatedTime": "1776060255784",
        "computerFullName": "AlvaroSantiago",
        "osName": "--",
        "subnetMask": "--",
        "uuId": "--",
        "customerName": "DC_CUSTOMER",
        "macAddress": "--",
        "osVersion": "--",
        "computerName": "AlvaroSantiago",
        "dbAddedTime": "1776060255606",
        "domainName": "WORKGROUP",
        "guid": "--",
        "remoteOfficeName": "Local Office",
        "remoteIpAddr": "127.0.0.1"
      }
    ],
    "page": 1
  }
                
Show full

Sample Response: HTTP 401

User not authorized to view these computers

Copied!
  {
    "errorCode": "1001",
    "message": "User is not authorized to access the requested computers",
    "statusCode": 401
  }
                
Show full

Duration: 1 minute | Threshold: 30 | Lock period: 5 minutes

Duration - Time window for the threshold.
Threshold - Number of API calls allowed within the specified duration.
Lock Period - Wait time before consecutive API requests.