---
title: "Get cluster by filters"
method: GET
path: "/cluster"
tags: ["clusters"]
---

# Get cluster by filters

`GET /cluster`

Get cluster by filters

## Query parameters

- `name` string, custom-name, required

## Response `200`

Get cluster by filters

- Cluster
  - `components` IntegrationComponents, required
    - `credentialsOperator` CredentialsOperatorComponent, required
      - `status` ComponentStatus, required
        - `lastSeen` string, date-time
        - `type` 'NOT_INTEGRATED' | 'CONNECTED' | 'DISCONNECTED', required
      - `type` 'INTENTS_OPERATOR' | 'CREDENTIALS_OPERATOR' | 'NETWORK_MAPPER', required
    - `intentsOperator` IntentsOperatorComponent, required
      - `configuration` IntentsOperatorConfiguration
        - `awsIAMPolicyEnforcementEnabled` boolean, required
        - `azureIAMPolicyEnforcementEnabled` boolean, required
        - `databaseEnforcementEnabled` boolean, required
        - `egressNetworkPolicyEnforcementEnabled` boolean, required
        - `enforcedNamespaces` string[]
        - `gcpIAMPolicyEnforcementEnabled` boolean, required
        - `globalEnforcementEnabled` boolean, required
        - `istioPolicyEnforcementEnabled` boolean, required
        - `kafkaACLEnforcementEnabled` boolean, required
        - `linkerdPolicyEnforcementEnabled` boolean, required
        - `networkPolicyEnforcementEnabled` boolean, required
        - `protectedServices` object[], required
          - `id` string, required
        - `protectedServicesEnabled` boolean, required
      - `status` ComponentStatus, required
        - `lastSeen` string, date-time
        - `type` 'NOT_INTEGRATED' | 'CONNECTED' | 'DISCONNECTED', required
      - `type` 'INTENTS_OPERATOR' | 'CREDENTIALS_OPERATOR' | 'NETWORK_MAPPER', required
    - `networkMapper` NetworkMapperComponent, required
      - `status` ComponentStatus, required
        - `lastSeen` string, date-time
        - `type` 'NOT_INTEGRATED' | 'CONNECTED' | 'DISCONNECTED', required
      - `type` 'INTENTS_OPERATOR' | 'CREDENTIALS_OPERATOR' | 'NETWORK_MAPPER', required
  - `configuration` ClusterConfiguration
    - `clusterFormSettings` ClusterFormSettings, required
      - `certificateProvider` 'SPIRE' | 'CERT_MANAGER' | 'CLOUD' | 'NONE', required
      - `enforcement` boolean, required
    - `globalDefaultDeny` boolean, required
    - `istioGlobalDefaultDeny` boolean, required
    - `linkerdGlobalDefaultDeny` boolean, required
    - `useAWSIAMInAccessGraphStates` boolean, required
    - `useAzureIAMInAccessGraphStates` boolean, required
    - `useDatabaseInAccessGraphStates` boolean, required
    - `useGCPIAMInAccessGraphStates` boolean, required
    - `useIstioPoliciesInAccessGraphStates` boolean, required
    - `useKafkaACLsInAccessGraphStates` boolean, required
    - `useLinkerdPoliciesInAccessGraphStates` boolean, required
    - `useNetworkPoliciesInAccessGraphStates` boolean, required
  - `createdAt` string, date-time, required
  - `defaultEnvironment` object
    - `id` string, required
  - `id` string, required
  - `integration` object
    - `id` string, required
  - `integrations` object[], required
    - `id` string, required
  - `name` string, required
  - `namespaces` object[], required
    - `id` string, required
  - `serviceCount` integer, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `408` — Request Timeout
- `409` — Conflict
- `422` — Unprocessable Entity
- `500` — Internal Server Error
- `default`

## Changes

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

- **2025-04-16** `6b4369907cb8` — 4 info
  - added the non-success response with the status `408`
  - added the required property `components/intentsOperator/configuration/linkerdPolicyEnforcementEnabled` to the response with the `200` status
  - added the required property `configuration/linkerdGlobalDefaultDeny` to the response with the `200` status
  - added the required property `configuration/useLinkerdPoliciesInAccessGraphStates` to the response with the `200` status
- **2024-10-21** `7aec65a7fcfd` — 5 info
  - added the optional property `components/intentsOperator/configuration/enforcedNamespaces` to the response with the `200` status
  - added the required property `components/intentsOperator/configuration/azureIAMPolicyEnforcementEnabled` to the response with the `200` status
  - added the required property `components/intentsOperator/configuration/gcpIAMPolicyEnforcementEnabled` to the response with the `200` status
  - added the required property `configuration/useAzureIAMInAccessGraphStates` to the response with the `200` status
  - …1 more
- …earlier changes not shown

[Full history](https://skmtc.dev/otterize/apis/otterize-api-server/changes/cluster/get.md)

---

[API](https://skmtc.dev/otterize/apis/otterize-api-server.md) · [All operations](https://skmtc.dev/otterize/apis/otterize-api-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/otterize/otterize-api-server/revisions/ec9167824493/schema)