---
title: "Get multiple instance groups"
method: GET
path: "/lifecycle-manager/resources/{modelIdentifier}/groups"
tags: ["Lifecycle Manager"]
---

# Get multiple instance groups

`GET /lifecycle-manager/resources/{modelIdentifier}/groups`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/lifecycle-manager/resources/{modelIdentifier}/groups`
- Auth: none declared

Returns multiple instance groups.

## Path parameters

- `modelIdentifier` union, required
  - string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
  - string: The name of the document

## Query parameters

- `skip` string
- `limit` string
- `sort` string
- `order` 'asc' | 'desc': This parameter specifies the direction to sort the search results over.
- `equals` LifecycleManagerResourcesModelIdentifierGroupsGetParametersEquals
  - `modelName` string: The name of the document
  - `type` 'manual' | 'dynamic'
  - `_id` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
  - `name` string: The name of the document
  - `modelId` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
  - `created` string, date-time: An ISO 8601 date string
  - `createdBy` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
  - `lastUpdated` string, date-time: An ISO 8601 date string
  - `lastUpdatedBy` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
- `in` LifecycleManagerResourcesModelIdentifierGroupsGetParametersIn: This parameter specifies a comma-delimited list of values to search for in the given field(s).
  - `type` LifecycleManagerResourcesModelIdentifierGroupsGetParametersInSchemaTypeItems[]
  - `lastAction` LifecycleManagerResourcesModelIdentifierGroupsGetParametersInSchemaLastAction
    - `type` LifecycleManagerResourcesModelIdentifierGroupsGetParametersInSchemaLastActionTypeItems[]
- `starts-with` LifecycleManagerResourcesModelIdentifierGroupsGetParametersStartsWith
  - `name` string: The name of the document
- `lt` LifecycleManagerResourcesModelIdentifierGroupsGetParametersLt
  - `created` string, date-time: An ISO 8601 date string
  - `lastUpdated` string, date-time: An ISO 8601 date string
- `lte` LifecycleManagerResourcesModelIdentifierGroupsGetParametersLte
  - `created` string, date-time: An ISO 8601 date string
  - `lastUpdated` string, date-time: An ISO 8601 date string
- `gt` LifecycleManagerResourcesModelIdentifierGroupsGetParametersGt
  - `created` string, date-time: An ISO 8601 date string
  - `lastUpdated` string, date-time: An ISO 8601 date string
- `gte` LifecycleManagerResourcesModelIdentifierGroupsGetParametersGte
  - `created` string, date-time: An ISO 8601 date string
  - `lastUpdated` string, date-time: An ISO 8601 date string
- `dereference` unknown

## Response `200`

response

- LifecycleManagerGetInstanceGroupsHttpResponse200
  - `data` LifecycleManagerInstanceGroupHttp[]
    - `createdBy` LifecycleManagerInstanceGroupHttpCreatedBy
      - `firstname` string
      - `provenance` string
      - `username` string
      - `_id` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
    - `created` string, date-time: An ISO 8601 date string
    - `lastUpdatedBy` LifecycleManagerInstanceGroupHttpLastUpdatedBy
      - `firstname` string
      - `provenance` string
      - `username` string
      - `_id` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
    - `lastUpdated` string, date-time: An ISO 8601 date string
    - `_id` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
    - `lastAction` LifecycleManagerInstanceGroupHttpLastAction: The last action that was run against this document
      - `_id` unknown, required
      - `executionId` string, required: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
      - `name` string, required: The name of the action
      - `type` 'import' | 'create' | 'update' | 'delete', required: The type of the action
      - `status` 'running' | 'error' | 'complete' | 'canceled' | 'paused', required: A single string describing the current activity status of this action
  - `metadata` LifecycleManagerCommonHttpPaginationMetadata: Properties describing search result pagination
    - `skip` integer
    - `limit` integer
    - `total` integer
    - `nextPageSkip` integer
    - `previousPageSkip` integer
    - `currentPageSize` integer

## Other responses

- `500`: Error response from API

## Changes

- **2026-10-31** `2095cc90e583`: 2 info
  - api tag `Lifecycle Manager` added
  - api tag `lifecycleManager` removed

[Operation history](https://skmtc.dev/itential/apis/itential-2/changes/lifecycle-manager/resources/:modelIdentifier/groups/get.md)

---

[API](https://skmtc.dev/itential/apis/itential-2.md) - [All operations](https://skmtc.dev/itential/apis/itential-2/llms.txt) - [OpenAPI document](https://skmtc.dev/itential/apis/itential-2/revisions/2095cc90e583?raw)