---
title: "Get resource instance"
method: GET
path: "/lifecycle-manager/resources/{modelId}/instances/{instanceId}"
tags: ["Lifecycle Manager"]
---

# Get resource instance

`GET /lifecycle-manager/resources/{modelId}/instances/{instanceId}`

## Request

- Base URL: `https://example.itential.io`
- URL: `https://example.itential.io/lifecycle-manager/resources/{modelId}/instances/{instanceId}`
- Auth: none declared

Returns the resource instance.

## Path parameters

- `modelId` string, required: A MongoDB ObjectId
- `instanceId` string, required: A MongoDB ObjectId

## Query parameters

- `skip` string
- `limit` string
- `sort` string
- `order` 'asc' | 'desc': This parameter specifies the direction to sort the search results over.
- `equals` LifecycleManagerResourcesModelIdInstancesInstanceIdGetParametersEquals
  - `modelName` string: The name of the resource model
  - `stateName` string: The name of the current state of the resource instance
  - `_id` unknown
  - `name` string: The name of the resource instance
  - `modelId` unknown
  - `created` unknown
  - `createdBy` unknown
  - `lastUpdated` unknown
  - `lastUpdatedBy` unknown
  - `instanceData` object: Custom data associated with the resource instance, stored as a nested object. To filter on a specific value inside it, use dot notation as the property name with equals, in, or starts-with. For example, use instanceData.region. Property names beginning with '$' are not supported.
  - `lastAction` object: Details about the most recently executed action on the resource instance, stored as a nested object. To filter on a specific value inside it, use dot notation as the property name with equals, in, or starts-with. For example, use lastAction.status. Property names beginning with '$' are not supported.
- `in` LifecycleManagerResourcesModelIdInstancesInstanceIdGetParametersIn: This parameter specifies a comma-delimited list of values to search for in the given field(s).
  - `lastAction` LifecycleManagerResourcesModelIdInstancesInstanceIdGetParametersInSchemaLastAction: Details about the most recently executed action on the resource instance, stored as a nested object. To filter on a specific value inside it, use dot notation as the property name with equals, in, or starts-with. For example, use lastAction.status. Property names beginning with '$' are not supported.
    - `type` LifecycleManagerResourcesModelIdInstancesInstanceIdGetParametersInSchemaLastActionTypeItems[]
  - `instanceData` object: Custom data associated with the resource instance, stored as a nested object. To filter on a specific value inside it, use dot notation as the property name with equals, in, or starts-with. For example, use instanceData.region. Property names beginning with '$' are not supported.
- `include-deleted` 'true' | 'false'
- `starts-with` LifecycleManagerResourcesModelIdInstancesInstanceIdGetParametersStartsWith
  - `name` string: The name of the resource instance
  - `instanceData` object: Custom data associated with the resource instance, stored as a nested object. To filter on a specific value inside it, use dot notation as the property name with equals, in, or starts-with. For example, use instanceData.region. Property names beginning with '$' are not supported.
  - `lastAction` object: Details about the most recently executed action on the resource instance, stored as a nested object. To filter on a specific value inside it, use dot notation as the property name with equals, in, or starts-with. For example, use lastAction.status. Property names beginning with '$' are not supported.
- `group` string
- `instanceGroups` 'true' | 'false'
- `lt` LifecycleManagerResourcesModelIdInstancesInstanceIdGetParametersLt
  - `created` unknown
  - `lastUpdated` unknown
- `lte` LifecycleManagerResourcesModelIdInstancesInstanceIdGetParametersLte
  - `created` unknown
  - `lastUpdated` unknown
- `gt` LifecycleManagerResourcesModelIdInstancesInstanceIdGetParametersGt
  - `created` unknown
  - `lastUpdated` unknown
- `gte` LifecycleManagerResourcesModelIdInstancesInstanceIdGetParametersGte
  - `created` unknown
  - `lastUpdated` unknown
- `include` LifecycleManagerResourcesModelIdInstancesInstanceIdGetParametersIncludeSchemaItems[]
- `exclude` LifecycleManagerResourcesModelIdInstancesInstanceIdGetParametersExcludeSchemaItems[]
- `dereference` unknown

## Response `200`

response

- LifecycleManagerGetResourceInstanceHttpResponse200
  - `data` LifecycleManagerResourceInstanceHttp
    - `_id` unknown, required
    - `name` string, required: The name of the resource instance
    - `description` string, required: Free-form text describing the resource instance
    - `modelId` unknown, required
    - `instanceData` LifecycleManagerResourceInstanceHttpInstanceData, required: The data for the resource instance
    - `lastAction` LifecycleManagerResourceInstanceHttpLastAction, required: The last action that was run on this instance
      - `_id` unknown, required
      - `executionId` unknown, required
      - `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
    - `created` unknown, required
    - `createdBy` unknown, required
    - `lastUpdated` unknown, required
    - `lastUpdatedBy` unknown, required
    - `instanceGroups` LifecycleManagerResourceInstanceHttpInstanceGroupsItems[]: The groups that this resource instance is a member of
      - `_id` string: A string which is formatted like an ObjectId, Distinct from an actual ObjectId.
      - `name` string: The name of the document

## 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/:modelId/instances/:instanceId/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)