---
title: "List Diagnostics collection."
method: GET
path: "/api/diagnostics"
tags: ["Diagnostics"]
---

# List Diagnostics collection.

`GET /api/diagnostics`

*Diagnostics* collection with up to **TODO** items of the following *Diagnostic* types:
- `threadNetworkDiscovery` **TODO**
- `threadNetworkDiagnostic`
- `threadEnergyScanReport`

## Background Logic
- when a new item is added, old items may be removed (oldest first) to free enough memory
- all *Diagnostic* items are created through their corresponding *Task*

## Query parameters

- `fields` object

## Response `200`

(JSON:API) document with with up to TODO `data` objects representing *Diagnostic* items that must have the following members:
- `id`: unique diagnostic ID assigned by the server
- `type` diagnostic type (see *Schema*)
- `attributes`: diagnostic-specific attributes (see *Schema*)

- union
  - object[]
  - object

## Other responses

- `400` — The client sent an invalid request. The client SHOULD perform action(s) to provide valid syntax before retrying the request.
- `406` — The client requests a content-type that is not supported by the target resource. The client SHOULD perform action(s) to re-align with the API before retrying the request.
- `500` — The server encountered an unexpected error. The client SHOULD retry after a longer period of time.

---

[API](https://skmtc.net/openthread/apis/swagger-openthread-rest-api.md) · [All operations](https://skmtc.net/openthread/apis/swagger-openthread-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openthread/swagger-openthread-rest-api/revisions/7996e8479177/schema)