---
title: "Fetch Clusterlint Diagnostics for a Kubernetes Cluster"
method: GET
path: "/v2/kubernetes/clusters/{cluster_id}/clusterlint"
tags: ["DigitalOcean-public.v2-new_Kubernetes"]
---

# Fetch Clusterlint Diagnostics for a Kubernetes Cluster

`GET /v2/kubernetes/clusters/{cluster_id}/clusterlint`

To request clusterlint diagnostics for your cluster, send a GET request to
`/v2/kubernetes/clusters/$K8S_CLUSTER_ID/clusterlint`. If the `run_id` query
parameter is provided, then the diagnostics for the specific run is fetched.
By default, the latest results are shown.

To find out how to address clusterlint feedback, please refer to
[the clusterlint check documentation](https://github.com/digitalocean/clusterlint/blob/master/checks.md).

## Path parameters

- `cluster_id` string, uuid, required

## Query parameters

- `run_id` string, uuid

## Response `200`

The response is a JSON object which contains the diagnostics on Kubernetes
objects in the cluster. Each diagnostic will contain some metadata information
about the object and feedback for users to act upon.

- ClusterlintResults
  - `run_id` string — Id of the clusterlint run that can be used later to fetch the diagnostics.
  - `requested_at` string, date-time — A time value given in ISO8601 combined date and time format that represents when the schedule clusterlint run request was made.
  - `completed_at` string, date-time — A time value given in ISO8601 combined date and time format that represents when the schedule clusterlint run request was completed.
  - `diagnostics` object[] — An array of diagnostics reporting potential problems for the given cluster.
    - `check_name` string — The clusterlint check that resulted in the diagnostic.
    - `severity` string — Can be one of error, warning or suggestion.
    - `message` string — Feedback about the object for users to fix.
    - `object` object — Metadata about the Kubernetes API object the diagnostic is reported on.
      - `name` string — Name of the object
      - `kind` string — The kind of Kubernetes API object
      - `namespace` string — The namespace the object resides in the cluster.

## Other responses

- `401` — Authentication failed due to invalid credentials.
- `404` — The resource was not found.
- `429` — The API rate limit has been exceeded.
- `500` — There was a server error.
- `default` — There was an unexpected error.

---

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