All pages
Powered by GitBook
1 of 1

Loading...

Get query result

GetAssessmentQueryResult returns the total number of results for a saved query.

To get node details for the source entity type, use . To get related destination nodes for an individual result, use .

Sample request:

Sample Response:

The response will include a number_value representing the total number of results.

curl -X 'GET' "$BASE_URL/api/v1/assessments/queries/6288f9ac-ff58-49b1-87a0-79ae7572448f:result" \
-H "authorization: Bearer $VEZA_TOKEN"
{
    "result_type": "number",
    "number_value": "6"
}
GetAssessmentQueryNodes
GetAssessmentQueryDestinationNodes
get
Authorizations
AuthorizationstringRequired

Veza API key for authentication. Generate keys in Administration > API Keys.

Path parameters
idstringRequired
Query parameters
snapshot_idstringOptional
include_result_statisticsbooleanOptional
include_approx_total_source_nodes_countbooleanOptional
page_sizestringOptional

The maximum number of results to be returned. Fewer results may be returned even when more pages exist.

page_tokenstringOptional

The token specifying the specific page of results to retrieve.

Responses
200

OK

application/json
result_typestringOptional
number_valuestringOptional
timestamp_valuestringOptional
idstringOptional
typestringOptional
propertiesobjectOptional
destination_node_countinteger · int32Optional
idstringOptional
typestringOptional
propertiesobjectOptional
destination_node_countinteger · int32Optional
permissionsobject · AssessmentQueryNode[]OptionalDeprecated
⤷Circular reference to object · AssessmentQueryNode[]
engagement_scoreinteger · int32Optional
over_provisioned_scoreinteger · int32Optional
total_countstringOptional
accessed_countstringOptional
last_usedstring · date-timeOptional
countinteger · int32Optional
concrete_permissionsstring[]Optional
canonical_permissionsstring[]Optional
destination_node_idsstring[]OptionalDeprecated
risk_levelinteger · enumOptional
raw_permissionsstring[]Optional

Effective permissions. These three should be a separate object, but we are preserving backwards compatibility; treat these as a linked group.

effective_permissionsstring[]Optional
conditionsstring[]Optional
destination_node_percentage_of_totalnumber · floatOptional
typestringOptional
keystringOptional
valuestringOptional
Other propertiesanyOptional

Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.

typestringOptional
keystringOptional
valuestringOptional
Other propertiesanyOptional

Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.

filtered_raw_permissionsstring[]Optional
corresponding_effective_permissionsstring[]Optional
last_usedstring · date-timeOptional
namestringOptional
last_usedstring · date-timeOptional
role_substitution_recommended_rolestringOptional
role_substitution_reason_for_high_priv_rolestringOptional
role_substitution_errorstringOptional
default_cohort_role_users_in_cohortstring[]Optional
default_cohort_rolestringOptional
default_cohort_role_all_common_rolesstring[]Optional
default_cohort_role_errorstringOptional
timestring · date-timeOptional
login_countstringOptional
median_login_countnumber · floatOptional
outlier_predictionnumber · floatOptional
predictionnumber · floatOptional
scorenumber · floatOptional
namestringOptional
valuenumber · floatOptional
explanationstringOptional
query_idstringOptional
suppressedbooleanOptional
risk_levelinteger · enumOptional
integration_typestringOptional
idstringOptional
typestringOptional
propertiesobjectOptional
destination_node_countinteger · int32Optional
permissionsobject · AssessmentQueryNode[]OptionalDeprecated
⤷Circular reference to object · AssessmentQueryNode[]
engagement_scoreinteger · int32Optional
over_provisioned_scoreinteger · int32Optional
total_countstringOptional
accessed_countstringOptional
last_usedstring · date-timeOptional
countinteger · int32Optional
concrete_permissionsstring[]Optional
canonical_permissionsstring[]Optional
destination_node_idsstring[]OptionalDeprecated
risk_levelinteger · enumOptional
raw_permissionsstring[]Optional

Effective permissions. These three should be a separate object, but we are preserving backwards compatibility; treat these as a linked group.

effective_permissionsstring[]Optional
conditionsstring[]Optional
destination_node_percentage_of_totalnumber · floatOptional
typestringOptional
keystringOptional
valuestringOptional
Other propertiesanyOptional

Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.

typestringOptional
keystringOptional
valuestringOptional
Other propertiesanyOptional

Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.

filtered_raw_permissionsstring[]Optional
corresponding_effective_permissionsstring[]Optional
last_usedstring · date-timeOptional
namestringOptional
last_usedstring · date-timeOptional
role_substitution_recommended_rolestringOptional
role_substitution_reason_for_high_priv_rolestringOptional
role_substitution_errorstringOptional
default_cohort_role_users_in_cohortstring[]Optional
default_cohort_rolestringOptional
default_cohort_role_all_common_rolesstring[]Optional
default_cohort_role_errorstringOptional
timestring · date-timeOptional
login_countstringOptional
median_login_countnumber · floatOptional
outlier_predictionnumber · floatOptional
predictionnumber · floatOptional
scorenumber · floatOptional
namestringOptional
valuenumber · floatOptional
explanationstringOptional
query_idstringOptional
suppressedbooleanOptional
risk_levelinteger · enumOptional
integration_typestringOptional
joined_nodesobjectOptional
⤷Circular reference to object
additional_spec_propertiesobjectOptional

Additional properties from the originating union query spec. This is populated from or union_specs[i].additional_spec_properties (for union queries). Each result will have the additional_spec_properties from the query spec that generated it, allowing you to correlate results back to their originating spec in union queries.

additional_spec_propertiesobjectOptional

Additional properties from the originating union query spec. This is populated from or union_specs[i].additional_spec_properties (for union queries). Each result will have the additional_spec_properties from the query spec that generated it, allowing you to correlate results back to their originating spec in union queries.

engagement_scoreinteger · int32Optional
over_provisioned_scoreinteger · int32Optional
total_countstringOptional
accessed_countstringOptional
last_usedstring · date-timeOptional
countinteger · int32Optional
concrete_permissionsstring[]Optional
canonical_permissionsstring[]Optional
destination_node_idsstring[]OptionalDeprecated
risk_levelinteger · enumOptional
raw_permissionsstring[]Optional

Effective permissions. These three should be a separate object, but we are preserving backwards compatibility; treat these as a linked group.

effective_permissionsstring[]Optional
conditionsstring[]Optional
destination_node_percentage_of_totalnumber · floatOptional
typestringOptional
keystringOptional
valuestringOptional
Other propertiesanyOptional

Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.

typestringOptional
keystringOptional
valuestringOptional
Other propertiesanyOptional

Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.

filtered_raw_permissionsstring[]Optional
corresponding_effective_permissionsstring[]Optional
last_usedstring · date-timeOptional
namestringOptional
last_usedstring · date-timeOptional
role_substitution_recommended_rolestringOptional
role_substitution_reason_for_high_priv_rolestringOptional
role_substitution_errorstringOptional
default_cohort_role_users_in_cohortstring[]Optional
default_cohort_rolestringOptional
default_cohort_role_all_common_rolesstring[]Optional
default_cohort_role_errorstringOptional
timestring · date-timeOptional
login_countstringOptional
median_login_countnumber · floatOptional
outlier_predictionnumber · floatOptional
predictionnumber · floatOptional
scorenumber · floatOptional
namestringOptional
valuenumber · floatOptional
explanationstringOptional
query_idstringOptional
suppressedbooleanOptional
risk_levelinteger · enumOptional
integration_typestringOptional
idstringOptional
typestringOptional
propertiesobjectOptional
destination_node_countinteger · int32Optional
idstringOptional
typestringOptional
propertiesobjectOptional
destination_node_countinteger · int32Optional
permissionsobject · AssessmentQueryNode[]OptionalDeprecated
⤷Circular reference to object · AssessmentQueryNode[]
engagement_scoreinteger · int32Optional
over_provisioned_scoreinteger · int32Optional
total_countstringOptional
accessed_countstringOptional
last_usedstring · date-timeOptional
countinteger · int32Optional
concrete_permissionsstring[]Optional
canonical_permissionsstring[]Optional
destination_node_idsstring[]OptionalDeprecated
risk_levelinteger · enumOptional
raw_permissionsstring[]Optional

Effective permissions. These three should be a separate object, but we are preserving backwards compatibility; treat these as a linked group.

effective_permissionsstring[]Optional
conditionsstring[]Optional
destination_node_percentage_of_totalnumber · floatOptional
typestringOptional
keystringOptional
valuestringOptional
Other propertiesanyOptional

Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.

typestringOptional
keystringOptional
valuestringOptional
Other propertiesanyOptional

Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.

filtered_raw_permissionsstring[]Optional
corresponding_effective_permissionsstring[]Optional
last_usedstring · date-timeOptional
namestringOptional
last_usedstring · date-timeOptional
role_substitution_recommended_rolestringOptional
role_substitution_reason_for_high_priv_rolestringOptional
role_substitution_errorstringOptional
default_cohort_role_users_in_cohortstring[]Optional
default_cohort_rolestringOptional
default_cohort_role_all_common_rolesstring[]Optional
default_cohort_role_errorstringOptional
timestring · date-timeOptional
login_countstringOptional
median_login_countnumber · floatOptional
outlier_predictionnumber · floatOptional
predictionnumber · floatOptional
scorenumber · floatOptional
namestringOptional
valuenumber · floatOptional
explanationstringOptional
query_idstringOptional
suppressedbooleanOptional
risk_levelinteger · enumOptional
integration_typestringOptional
joined_nodesobjectOptional
⤷Circular reference to object
additional_spec_propertiesobjectOptional

Additional properties from the originating union query spec. This is populated from or union_specs[i].additional_spec_properties (for union queries). Each result will have the additional_spec_properties from the query spec that generated it, allowing you to correlate results back to their originating spec in union queries.

engagement_scoreinteger · int32Optional
over_provisioned_scoreinteger · int32Optional
total_countstringOptional
accessed_countstringOptional
last_usedstring · date-timeOptional
countinteger · int32Optional
concrete_permissionsstring[]Optional
canonical_permissionsstring[]Optional
destination_node_idsstring[]OptionalDeprecated
risk_levelinteger · enumOptional
raw_permissionsstring[]Optional

Effective permissions. These three should be a separate object, but we are preserving backwards compatibility; treat these as a linked group.

effective_permissionsstring[]Optional
conditionsstring[]Optional
destination_node_percentage_of_totalnumber · floatOptional
typestringOptional
keystringOptional
valuestringOptional
Other propertiesanyOptional

Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.

typestringOptional
keystringOptional
valuestringOptional
Other propertiesanyOptional

Represents a dynamically typed value which can be either null, a number, a string, a boolean, a recursive struct value, or a list of values.

filtered_raw_permissionsstring[]Optional
corresponding_effective_permissionsstring[]Optional
last_usedstring · date-timeOptional
namestringOptional
last_usedstring · date-timeOptional
role_substitution_recommended_rolestringOptional
role_substitution_reason_for_high_priv_rolestringOptional
role_substitution_errorstringOptional
default_cohort_role_users_in_cohortstring[]Optional
default_cohort_rolestringOptional
default_cohort_role_all_common_rolesstring[]Optional
default_cohort_role_errorstringOptional
timestring · date-timeOptional
login_countstringOptional
median_login_countnumber · floatOptional
outlier_predictionnumber · floatOptional
predictionnumber · floatOptional
scorenumber · floatOptional
namestringOptional
valuenumber · floatOptional
explanationstringOptional
query_idstringOptional
suppressedbooleanOptional
risk_levelinteger · enumOptional
integration_typestringOptional
joined_nodesobjectOptional
⤷Circular reference to object
additional_spec_propertiesobjectOptional

Additional properties from the originating union query spec. This is populated from or union_specs[i].additional_spec_properties (for union queries). Each result will have the additional_spec_properties from the query spec that generated it, allowing you to correlate results back to their originating spec in union queries.

additional_spec_propertiesobjectOptional

Additional properties from the originating union query spec. This is populated from or union_specs[i].additional_spec_properties (for union queries). Each result will have the additional_spec_properties from the query spec that generated it, allowing you to correlate results back to their originating spec in union queries.

next_page_tokenstringOptional

The pagination token to retrieve the next page of results.

has_morebooleanOptional

If true, more results are available.

max_destination_node_countstringOptional
min_destination_node_countstringOptional
avg_destination_node_countnumber · floatOptional
approx_total_source_nodes_countstringOptional
default

Default error response

application/json

The Status type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by gRPC. Each Status message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the API Design Guide.

codeinteger · int32Optional

The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].

messagestringOptional

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the [google.rpc.Status.details][google.rpc.Status.details] field, or localized by the client.

@typestringOptional

The type of the serialized message.

Other propertiesanyOptional
get/api/v1/assessments/queries/{id}:result
GET /api/v1/assessments/queries/{id}:result HTTP/1.1
Host: your-tenant.vezacloud.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*
{
  "result_type": "text",
  "number_value": "text",
  "timestamp_value": "text",
  "nodes_value": {
    "values": [
      {
        "id": "text",
        "type": "text",
        "properties": {},
        "destination_node_count": 1,
        "engagement_access_stats": {
          "engagement_score": 1,
          "over_provisioned_score": 1,
          "total_count": "text",
          "accessed_count": "text"
        },
        "access_stats": {
          "last_used": "2026-01-01T00:00:00.000Z",
          "count": 1,
          "concrete_permissions": [
            "text"
          ],
          "canonical_permissions": [
            "text"
          ]
        },
        "risk_level": 1,
        "raw_permissions": [
          "text"
        ],
        "effective_permissions": [
          "text"
        ],
        "unsupported_conditions": {
          "ANY_ADDITIONAL_PROPERTY": {
            "conditions": [
              "text"
            ]
          }
        },
        "destination_node_percentage_of_total": 1,
        "tags": [
          {
            "type": "text",
            "key": "text",
            "value": "text",
            "properties": {
              "ANY_ADDITIONAL_PROPERTY": null
            }
          }
        ],
        "specified_tags": [
          {
            "type": "text",
            "key": "text",
            "value": "text",
            "properties": {
              "ANY_ADDITIONAL_PROPERTY": null
            }
          }
        ],
        "filtered_raw_permissions": [
          "text"
        ],
        "corresponding_effective_permissions": [
          "text"
        ],
        "single_entity_access_stats": {
          "last_used": "2026-01-01T00:00:00.000Z",
          "last_used_with_events_for": [
            {
              "name": "text",
              "last_used": "2026-01-01T00:00:00.000Z"
            }
          ]
        },
        "additional_node_properties": {
          "role_substitution_recommended_role": "text",
          "role_substitution_reason_for_high_priv_role": "text",
          "role_substitution_error": "text",
          "default_cohort_role_users_in_cohort": [
            "text"
          ],
          "default_cohort_role": "text",
          "default_cohort_role_all_common_roles": [
            "text"
          ],
          "default_cohort_role_error": "text",
          "login_anomaly_detection_stats": [
            {
              "time": "2026-01-01T00:00:00.000Z",
              "login_count": "text",
              "median_login_count": 1,
              "outlier_prediction": 1
            }
          ],
          "outlier_prediction": {
            "prediction": 1,
            "score": 1,
            "contributing_features": [
              {
                "name": "text",
                "value": 1,
                "explanation": "text"
              }
            ]
          },
          "associated_risks": [
            {
              "query_id": "text",
              "suppressed": true,
              "risk_level": 1
            }
          ]
        },
        "integration_type": "text",
        "joined_nodes": {
          "ANY_ADDITIONAL_PROPERTY": {
            "id": "text",
            "type": "text",
            "properties": {},
            "destination_node_count": 1,
            "permissions": "[Circular Reference]",
            "engagement_access_stats": {
              "engagement_score": 1,
              "over_provisioned_score": 1,
              "total_count": "text",
              "accessed_count": "text"
            },
            "access_stats": {
              "last_used": "2026-01-01T00:00:00.000Z",
              "count": 1,
              "concrete_permissions": [
                "text"
              ],
              "canonical_permissions": [
                "text"
              ]
            },
            "risk_level": 1,
            "raw_permissions": [
              "text"
            ],
            "effective_permissions": [
              "text"
            ],
            "unsupported_conditions": {
              "ANY_ADDITIONAL_PROPERTY": {
                "conditions": [
                  "text"
                ]
              }
            },
            "destination_node_percentage_of_total": 1,
            "tags": [
              {
                "type": "text",
                "key": "text",
                "value": "text",
                "properties": {
                  "ANY_ADDITIONAL_PROPERTY": null
                }
              }
            ],
            "specified_tags": [
              {
                "type": "text",
                "key": "text",
                "value": "text",
                "properties": {
                  "ANY_ADDITIONAL_PROPERTY": null
                }
              }
            ],
            "filtered_raw_permissions": [
              "text"
            ],
            "corresponding_effective_permissions": [
              "text"
            ],
            "single_entity_access_stats": {
              "last_used": "2026-01-01T00:00:00.000Z",
              "last_used_with_events_for": [
                {
                  "name": "text",
                  "last_used": "2026-01-01T00:00:00.000Z"
                }
              ]
            },
            "additional_node_properties": {
              "role_substitution_recommended_role": "text",
              "role_substitution_reason_for_high_priv_role": "text",
              "role_substitution_error": "text",
              "default_cohort_role_users_in_cohort": [
                "text"
              ],
              "default_cohort_role": "text",
              "default_cohort_role_all_common_roles": [
                "text"
              ],
              "default_cohort_role_error": "text",
              "login_anomaly_detection_stats": [
                {
                  "time": "2026-01-01T00:00:00.000Z",
                  "login_count": "text",
                  "median_login_count": 1,
                  "outlier_prediction": 1
                }
              ],
              "outlier_prediction": {
                "prediction": 1,
                "score": 1,
                "contributing_features": [
                  {
                    "name": "text",
                    "value": 1,
                    "explanation": "text"
                  }
                ]
              },
              "associated_risks": [
                {
                  "query_id": "text",
                  "suppressed": true,
                  "risk_level": 1
                }
              ]
            },
            "integration_type": "text",
            "joined_nodes": "[Circular Reference]",
            "additional_spec_properties": {}
          }
        },
        "additional_spec_properties": {}
      }
    ],
    "next_page_token": "text",
    "has_more": true
  },
  "result_statistics": {
    "max_destination_node_count": "text",
    "min_destination_node_count": "text",
    "avg_destination_node_count": 1
  },
  "approx_total_source_nodes_count": "text"
}