Phone Live Chat
US: +1 888 720 9500
US: +1 800 443 6694
Intl: +1 925 924 9500
Aus: +1 800 631 268
UK: 0800 028 6590
CN: +86 400 660 8680

Direct Inward Dialing: +1 408 916 9393

Search Group

Search Group

Use this API to search a group in Active Directory (AD) from your application.

Request URL (JSON) format: http://<hostname>:/RestAPI/SearchGroup

Request parameters:

Following are the request parameters that can be used while searching for an AD group:

Parameter name Mandatory Description
domainName Yes Domain where the group is located.
AuthToken Yes Authentication Token obtained using the Generate AuthToken API.
RANGE Yes Number of group details to be returned in the response.
FROM_INDEX Yes Starting index for the group details result.
searchText Yes Text that must be used to search the group.
PRODUCT_NAME Yes Product name/module name from which the request is being sent; will be needed for auditing.
refresh No Server will be refreshed to update the changes made to AD groups in ADManager Plus.
isPrimaryGroup No Lists the global security groups in the domain.


The response will be a JSON array string with a list of JSONObjects. Each JSONObject in the list represents an object sent in the inputFormat attribute in the request. Each object will contain the following properties about the status:

Parameter name Description
GROUP_NAME Name of the group.
DISTINGUISHED_NAME Distinguished name of the group.
SAM_ACCOUNT_NAME sAMAccountName of the group.

Sample request format:


Sample response format:

        "GROUP_NAME": "Finance Department",
        "DISTINGUISHED_NAME": "CN=Finance Department,CN=Users,DC=division,DC=com",
        "SAM_ACCOUNT_NAME": "Finance Department"
        "GROUP_NAME": "Production Department",
        "DISTINGUISHED_NAME": "CN=Production Department,CN=Users,DC=division,DC=com",
        "SAM_ACCOUNT_NAME": "Production Department"
        "GROUP_NAME": "Marketing Department",
        "DISTINGUISHED_NAME": "CN=Marketing Department,OU=Finance-OU,DC=division,DC=com",
        "SAM_ACCOUNT_NAME": "Marketing Department"
        "GROUP_NAME": "Account Operators",
        "DISTINGUISHED_NAME": "CN=Account Operators,OU=Finance-OU,DC=division,DC=com",
        "SAM_ACCOUNT_NAME": "Account Operators"
        "GROUP_NAME": "Administrators",
        "DISTINGUISHED_NAME": "CN=Administrators,OU=HR,DC=division,DC=com",
        "SAM_ACCOUNT_NAME": "Administrators"

ADManager Plus Trusted By

The one-stop solution to Active Directory Management and Reporting
Email Download Link