Retrieves computers pending approval or with a specific approval status. Used in the computer approval workflow. Supports filtering by approval status and computer name.
get /dcapi/som/approval/computers-info
https://{server-hostname}:8383/dcapi/som/approval/computers-info
SOM.READCopied!
Authorization: d92d4xxxxxxxxxxxxx15f52
curl --request GET \
--url https://appdomain/dcapi/som/approval/computers-info \
--header 'Accept: application/approvalComputersRes.v1+json' \
--header 'Authorization: d92d4xxxxxxxxxxxxx15f52'Total number of computer records matching the specified filter criteria across all pages
Array of computer information objects for the current page, each containing details about the computer's approval status, network configuration, and domain membership
Approval status code: 1 = approved, 2 = denied, 3 = pending approval
Unique resource identifier of the computer in the system
Operating system service pack version. Returns '--' if unavailable
Fully qualified domain name of the computer (e.g., 'PC01.corp.example.com'). Returns '--' if unavailable
IPv4 address of the computer. Returns '--' if unavailable
Timestamp in epoch milliseconds of when the computer record was last updated in the database
Full display name of the computer including domain prefix (e.g., 'DOMAIN\PC01')
Full operating system name (e.g., 'Windows 11 Enterprise'). Returns '--' if unavailable
Subnet mask of the computer's network interface. Returns '--' if unavailable
Universally unique identifier (UUID) of the computer hardware. Returns '--' if unavailable
Name of the customer or tenant this computer belongs to
MAC address of the computer's primary network interface. Returns '--' if unavailable
Operating system version number. Returns '--' if unavailable
NetBIOS or hostname of the computer (e.g., 'PC01')
Timestamp in epoch milliseconds of when the computer was first added to the database
Name of the Active Directory domain or workgroup the computer belongs to
Globally unique identifier (GUID) of the computer object. Returns '--' if unavailable
Name of the remote office this computer is assigned to
Remote/external IP address of the computer as seen by the server
Current page number in the paginated result set (1-based)
Unauthorized error code returned when authentication credentials are missing, expired, or invalid (authentication=required)
Authentication failure reason
Computers pending approval
{
"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
}
User not authorized to view these computers
{
"errorCode": "1001",
"message": "User is not authorized to access the requested computers",
"statusCode": 401
}
![]()
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.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.
© 2026, Zoho Corporation Pvt. Ltd. All Rights Reserved.