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 |
| operation | Optional | String |
Logical operator used to combine multiple filters. Supported values: AND, OR |
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 TECHNOLOGIES",
"field": "orgs.name",
"operator": "EQUALS"
}
],
"operation": "AND"
}'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="orgs.name" operator="EQUALS">
<value>QUALYS TECHNOLOGIES</value>
</Criteria>
</filters>
<operation>AND</operation>
API Response
{
"responseMessage": "Valid API Access",
"responseCode": "SUCCESS",
"hasMore": 0,
"count": 6,
"organizationListData": {
"organizations": [
{
"name": "QUALYS",
"assets": 3011,
"orgSource": "EASM",
"isUserDefined": false,
"lastUpdated": "2025-10-15"
},
{
"name": "Qualys, Inc",
"assets": 3011,
"orgSource": "EASM",
"isUserDefined": false,
"lastUpdated": "2025-10-15"
},
{
"name": "Standard Chartered Bank",
"assets": 11,
"orgSource": "EASM",
"isUserDefined": false,
"lastUpdated": "2025-10-16"
},
{
"name": "QUALYS",
"assets": 3011,
"orgSource": "EASM",
"isUserDefined": false,
"lastUpdated": "2025-10-15"
},
{
"name": "Accenture",
"assets": 47,
"orgSource": "EASM",
"isUserDefined": false,
"lastUpdated": "2025-10-15"
},
{
"name": "STANDARD CHARTERED BANK (SINGAPORE) LIMITED",
"assets": 7,
"orgSource": "EASM",
"isUserDefined": false,
"lastUpdated": "2025-10-16"
},
{
"name": "Toronto Dominion Bank",
"assets": 17,
"orgSource": "EASM",
"isUserDefined": false,
"lastUpdated": "2025-10-16"
}
]
}
},
{
"responseCode": "SUCCESS",
"organizationListData": {
"organizations": [
{
"name": "Acme Corporation",
"assets": 150,
"truRisk": 75,
"businessValue": 95,
"country": "CA",
"orgSource": "EASM",
"businessValueSource": "username",
"currency": "USD",
"isUserDefined": true,
"lastUpdated": "2025-09-29T08:30:00Z"
}
]
},
"hasMore": 1,
"count": 1
}
For the supported tokens and operator list, refer to Supported Operators.