---
title: "Provides iterative namespace traversal for a context"
method: GET
path: "/pmapi/children"
tags: ["PMAPI HOST SERVICES"]
---

# Provides iterative namespace traversal for a context

`GET /pmapi/children`

The *children* endpoint provides iterative namespace traversal for a context. If no parameters are supplied, the response will describe the direct descendants of the 
Performance Metrics Name Space (PMNS) root.

The *prefix* parameter can be used to specify a subtree of the PMNS for traversal.

The server response is a JSON document that provides the set of leaf and non-leaf nodes below the given namespace node or root.
```
$ curl -s http://localhost:44322/pmapi/children?prefix=mem | pmjson
```
**Reference:** [pmGetChildren](https://man7.org/linux/man-pages/man3/pmGetChildren.3.html)(3), [pmGetChildrenStatus](https://man7.org/linux/man-pages/man3/pmGetChildrenStatus.3.html)(3)

## Query parameters

- `prefix` 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/children/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)