---
title: "POST /reports/assets:getSnapshot"
method: POST
path: "/reports/assets:getSnapshot"
tags: ["Reports"]
---

# POST /reports/assets:getSnapshot

`POST /reports/assets:getSnapshot`

Get the most recent snapshot of asset summary values for the snapshot request.

## Query parameters

- `api-version` string, required

## Request body

- ReportAssetSnapshotRequest — A request body used to retrieve an asset report snapshot.
  - `metric` string — The metric to retrieve a snapshot for.
  - `labelName` string — The name of the label to retrieve a snapshot for.
  - `size` integer — The number of assets per page.
  - `page` integer — The page to retrieve.

## Response `200`

The request has succeeded.

- ReportAssetSnapshotResult — A snapshot of assets captured daily for the provided metric. Asset details only contain primary properties. Detailed asset data can be retrieved from the asset endpoints.
  - `displayName` string — The name of the metric.
  - `metric` string — The unique metric name.
  - `labelName` string — The customer label that was filtered on, if one was provided.
  - `updatedAt` string, date-time — The last time this asset data was updated on this metric.
  - `description` string — A description of what the metric represents.
  - `assets` AssetPageResult — The page of assets that match the provided metric.
    - `totalElements` integer — The total number of items available in the full result set.
    - `mark` string — The cursor mark to be used on the next request. Not set if using paging.
    - `nextLink` string — The link to access the next page of results. Not set if at the end of the result set.
    - `value` AssetResource[] — The items in the current page of results.
      - `kind` string, required — Discriminator property for AssetResource.
      - `id` string, required — The system generated unique id for the resource.
      - `name` string — The caller provided unique name for the resource.
      - `displayName` string — The name that can be used for display purposes.
      - `uuid` string, uuid — Universally Unique Identifier
      - `createdDate` string, date-time — The date this asset was first added to this workspace.
      - `updatedDate` string, date-time — The date this asset was last updated for this workspace.
      - `state` 'candidate' | 'confirmed' | 'dismissed' | 'candidateInvestigate' | 'associatedPartner' | 'associatedThirdparty' | 'archived' — The state of assets
      - `externalId` string — An optional customer provided identifier for this asset.
      - `labels` string[] — Customer labels assigned to this asset.
      - `wildcard` boolean — An indicator of whether this asset represents a wildcard rollup of assets on this domain.
      - `discoGroupName` string — The name of the DiscoGroup that brought added this asset to the workspace.
      - `auditTrail` AuditTrailItem[] — The history of how this asset was pulled into the workspace through the discovery process.
        - `id` string — This is typically the same as the name but might be different for different models.
        - `name` string — The caller provided unique name for the resource.
        - `displayName` string — The name that can be used for display purposes.
        - `kind` 'as' | 'contact' | 'domain' | 'host' | 'ipAddress' | 'ipBlock' | 'page' | 'sslCert' — The kind of asset.
        - `reason` string — An explanation of why this audit trail node was discovered from the previous node.
      - `reason` string

## 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)