Get Organization or Subsidiaries List API
Use this API to fetch the list of organizations or subsidiaries that match your search criteria.
Input Filter ParametersInput Filter Parameters
| Filter Parameter | Mandatory/ Optional |
Data Type | Description |
|---|---|---|---|
| filters | Optional | Object | List of filter conditions used to refine search results. |
| value | Optional | String | The value to match against the specified field. |
| field | Optional | String | The name of the field on which the filter is applied. |
| operator | Optional | String | Comparison logic used for the filter condition.
Supported values: CONTAINS, IN, EQUALS, NOT_EQUALS |
API Request with filter in JSON
curl -X POST
'<qualys_base_url>/rest/2.0/am/organization/list'
-H 'accept: application/json'
-H 'Content-Type: application/json'
-d '{
"filters": [
{
"value": "QUALYS",
"field": "org.name",
"operator": "EQUALS"
}
]
}'API Request with filter in XML
curl -X POST
'<qualys_base_url>/rest/2.0/am/organization/list'
-H 'accept: application/xml'
-H 'Content-Type: application/xml'
-d '
<filters>
<Criteria field="org.name" operator="EQUALS">
<value>QUALYS</value>
</Criteria>
</filters>
API Response
{
"responseMessage": "Valid API Access",
"responseCode": "SUCCESS",
"hasMore": 0,
"count": 1,
"organizationListData": {
"organizations": [
{
"name": "QUALYS",
"assets": 2421,
"truRisk": 440,
"businessValue": 5000000000,
"country": "US",
"orgSource": "EASM",
"businessValueSource": "Qualys Estimate",
"currency": "USD",
"isUserDefined": false,
"lastUpdated": "2026-01-30"
}
]
}
}
For the supported tokens and operator list, refer to Supported Operators.