---
title: "POST /discoGroups:getAssetChainSummary"
method: POST
path: "/discoGroups:getAssetChainSummary"
tags: ["Discovery Groups"]
---

# POST /discoGroups:getAssetChainSummary

`POST /discoGroups:getAssetChainSummary`

Retrieve an asset chain summary.

## Query parameters

- `api-version` string, required

## Request body

- AssetChainRequest — AssetChainRequest containing information needed for the retrieval of the asset chain summary.
  - `assetChainSource` 'DISCO_GROUP' | 'ASSET', required — A list of asset chain sources
  - `sourceIds` string[], required — A collection of asset chain source ids.

## Response `200`

The request has succeeded.

- AssetChainSummaryResult — Response for the asset chain summary.
  - `affectedAssetsSummary` AssetChainKindSummaryResult[], required — A list of asset chain summaries per asset kind
    - `kind` 'as' | 'contact' | 'domain' | 'host' | 'ipAddress' | 'ipBlock' | 'page' | 'sslCert', required — The kind of asset.
    - `affectedCount` integer, required — The amount of assets affected for a given asset kind
  - `affectedGroupsSummary` DiscoGroupSummaryResult[], required — A list of disco group summaries
    - `id` string, required — The system generated unique id for the resource.
    - `name` string, required — The caller provided unique name for the resource.
    - `displayName` string, required — The name that can be used for display purposes.
  - `errors` AzureCoreFoundationsErrorResponseItem[] — The list of exceptions
    - `error` AzureCoreFoundationsError, required — The error object.
      - `code` string, required — One of a server-defined set of error codes.
      - `message` string, required — A human-readable representation of the error.
      - `target` string — The target of the error.
      - `details` AzureCoreFoundationsError[] — An array of details about specific errors that led to this reported error.
      - `innererror` AzureCoreFoundationsInnerError — An object containing more specific information about the error. As per Azure REST API guidelines - https://aka.ms/AzureRestApiGuidelines#handling-errors.
        - `code` string — One of a server-defined set of error codes.
        - `innererror` AzureCoreFoundationsInnerError — recursive
    - `errorCode` string — String error code indicating what went wrong.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/riskiq-microsoft-easm.md) · [All operations](https://skmtc.net/azure/apis/riskiq-microsoft-easm/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/riskiq-microsoft-easm/revisions/5865b52c51a3/schema)