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

# GET /discoGroups

`GET /discoGroups`

Retrieve a list of discovery group for the provided search parameters.

## Query parameters

- `api-version` string, required
- `filter` string
- `skip` integer
- `maxpagesize` integer

## Response `200`

The request has succeeded.

- PagedDiscoGroup — Paged collection of DiscoGroup items
  - `value` DiscoGroup[], required — The DiscoGroup items on this page
    - `id` string — This is typically the same as the name but might be different for different models.
    - `name` string, required — The caller provided unique name for the resource.
    - `displayName` string — The name that can be used for display purposes.
    - `description` string — The description for a disco group.
    - `tier` string — The tier for the disco group which will affect the algorithm used for the disco runs in this group.
    - `frequencyMilliseconds` integer — The frequency at which the disco group is supposed to be rerun in milliseconds.
    - `seeds` DiscoSource[] — The list of seeds used for the disco group runs.
      - `kind` 'as' | 'attribute' | 'contact' | 'domain' | 'host' | 'ipBlock' — The kind of disco source.
      - `name` string — The name for the disco source.
    - `names` string[] — The list of names used for the disco group runs.
    - `excludes` DiscoSource[] — The list of excludes used for the disco group runs, aka assets to exclude from the discovery algorithm.
      - `kind` 'as' | 'attribute' | 'contact' | 'domain' | 'host' | 'ipBlock' — The kind of disco source.
      - `name` string — The name for the disco source.
    - `latestRun` DiscoRunResult — The latest run of this disco group with some limited information, null if the group has never been run.
      - `submittedDate` string, date-time — The date for when the disco run was created in the system.
      - `startedDate` string, date-time — The date for when the disco run was actually started by the system.
      - `completedDate` string, date-time — The date for when the disco run was completed by the system.
      - `tier` string — The tier which will affect the algorithm used for the disco run.
      - `state` 'pending' | 'running' | 'completed' | 'failed' — The State of the disco run.
      - `totalAssetsFoundCount` integer — The total count of assets that were found this disco run.
      - `seeds` DiscoSource[] — The list of seeds used for the disco run.
        - `kind` 'as' | 'attribute' | 'contact' | 'domain' | 'host' | 'ipBlock' — The kind of disco source.
        - `name` string — The name for the disco source.
      - `excludes` DiscoSource[] — The list of excludes used for the disco run, aka assets to exclude from the discovery algorithm.
        - `kind` 'as' | 'attribute' | 'contact' | 'domain' | 'host' | 'ipBlock' — The kind of disco source.
        - `name` string — The name for the disco source.
      - `names` string[] — The list of names used for the disco run.
    - `createdDate` string, date-time — The date for the disco group was created.
    - `templateId` string — The unique identifier for the disco template used for the disco group creation.
  - `nextLink` string, uri — The link to the next page of items
  - `totalElements` integer — The total number of items available in the full result set.

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