Retrieves all domains (Active Directory and workgroup) in scope. Supports filtering by managed computers, AD type, managed users, and network type.
https://{serverurl}/dcapi/som/domains
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Specifies the page number to retrieve. Default is 1
Specifies the maximum number of items to return per page. The default value is 25. A maximum of 1000 records can be retrieved in a single request
Comma-separated list of fields to include in the response for projection
If set to true, returns only domains that have managed computers
If set to true, returns only domains that have managed users
If set to true, returns only Active Directory domains
If set to true, returns only directly joined Active Directory domains
Filters domains by network type. Accepts multiple values. Supported values: 1 (Workgroup), 2 (Active Directory), 3 (Entra AD)
Search value used to filter domains based on its name
curl --request GET \
--url https://appdomains/dcapi/som/domains \
--header 'Accept: application/domainsDetails.v1+json' \
--header 'Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52'Unique resource identifier of the domain in the system
Short display name of the domain (typically the NetBIOS name)
NetBIOS name of the domain used for authentication and network identification
Fully qualified domain name (FQDN) of the Active Directory domain (e.g., 'corp.example.com')
true if this is an Active Directory domain, false if it is a workgroup
Globally unique identifier (GUID) of the domain object in Active Directory
Whether authentication credentials are configured for this domain
Identifier of the credential associated with this domain. Fetch details from List Credentials
Universally unique identifier (UUID) of the credential associated with this domain
Username configured for domain access and AD operations
Whether there are any managed computers discovered under this domain
Whether SSL/TLS is used for LDAP communication with the domain controller
Port number used for LDAP communication (0 indicates default port)
Hostname of the domain controller used for AD sync operations
DNS suffix of the domain, typically matching the AD FQDN
Type of domain synchronization: 1 = Direction Connection, 2- Through AD Connector
Scheduled synchronization configuration including time, frequency, and timezone
Scheduled sync start time in HH:mm format (e.g., '02:00' for 2 AM)
Number of sync cycles remaining for the current day based on the configured frequency
Timezone used for the sync schedule (e.g., 'Asia/Kolkata', 'America/New_York')
Automatic Sync frequency per day
Internal Domain Manager identifier for this domain
Network type classification: 1- Workgroup, 2- Active Directory, 3 - Entra AD
Identifier of the AD Connector used for syncing this domain. null when no connector is configured
OAuth metadata identifier for Azure AD integration. null when OAuth is not configured
Type of OAuth authentication configured (e.g., Azure AD). null when OAuth is not configured
Active Directory domain
[
{
"resourceID": "311",
"adDomainName": "ECSOM.CBE.COM",
"adConnectorID": null,
"syncDetails": {
"syncTime": "06:00",
"remainingSyncCount": 3,
"timeZone": "Asia/Calcutta",
"frequency": 24
},
"oauthMetaID": null,
"hasManagedComputers": false,
"hasCredentials": true,
"portNumber": 0,
"useSSL": false,
"credentialUUID": "5be0e976-d613-46a0-bdc9-5a374fcadf53-1774869636432",
"dcName": "som-server-cbe",
"dnsSuffix": "ECSOM.CBE.COM",
"domainName": "ECSOM",
"dmDomainID": "1",
"name": "ECSOM",
"guid": "fd7b9f4a4dbdb14b916eb513c12e43f9",
"credentialID": "1",
"isADDomain": true,
"oauthType": null,
"syncType": 1,
"networkType": 2,
"username": "Administrator"
}
]
204 No Content![]()
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.