---
title: "List namespaces"
method: GET
path: "/namespaces"
tags: ["namespaces"]
---

# List namespaces

`GET /namespaces`

List namespaces

## Query parameters

- `environmentId` string, id
- `clusterId` string, id
- `name` string, k8s-name
- `filter` NamespaceFilterInput
  - `clusterIds` string[]
  - `environmentIds` string[]
  - `name` string

## Response `200`

List namespaces

- Namespace[]
  - `cluster` Cluster, required
    - `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
  - `environment` object, required
    - `id` string, required
  - `id` string, required
  - `name` string, required
  - `serviceCount` integer, required
  - `services` object[], required
    - `id` string, 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

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

[Full history](https://skmtc.dev/otterize/apis/otterize-api-server/changes/namespaces/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)