---
title: "Lists the current instances of an instance domain"
method: GET
path: "/pmapi/indom"
tags: ["PMAPI HOST SERVICES"]
---

# Lists the current instances of an instance domain

`GET /pmapi/indom`

This request lists the current instances of an instance domain. The instance domain is either specified directly (in numeric or string form) or 
indirectly, by association with the specified metric.

The request can be further qualified with a comma-separated list of the instances to report on, either by name or number, using the *instance* and 
*iname* parameters.

In the case of instance name qualifiers, these will be matched by exact string comparison by default. Alternatively, the match parameter can be used to 
specify that regular expression or glob pattern matching should be used instead.

The response is a JSON document that provides the instance domain metadata as an array.
```bash
$ curl -s http://localhost:44322/pmapi/indom?name=kernel.all.load | pmjson
```

**Reference:** [pmGetInDom](https://man7.org/linux/man-pages/man3/pmGetInDom.3.html)(3), [pmNameInDom](https://man7.org/linux/man-pages/man3/pmNameInDom.3.html)(3),
[pmLookupInDom](https://man7.org/linux/man-pages/man3/pmLookupInDom.3.html)(3)

## Query parameters

- `iname` string
- `indom` unknown
- `instance` number
- `match` string
- `name` string
- `hostspec` string
- `context` number
- `polltimeout` number
- `client` string

## Response `200`

OK

## Changes

> 16 revisions in range; 1 could not be searched.

- **2020-10-21** `26cabf98ddfb` — 1 info
  - endpoint added
- **2020-10-20** `7da0633fad91` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/performancecopilot/apis/pmwebapi/changes/pmapi/indom/get.md)

---

[API](https://skmtc.dev/performancecopilot/apis/pmwebapi.md) · [All operations](https://skmtc.dev/performancecopilot/apis/pmwebapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/performancecopilot/pmwebapi/revisions/666212c8ed6b/schema)