---
id: namespace-list
title: "List namespaces"
description: "List namespaces within an account."
sidebar_label: "List namespaces"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/namespace
custom_edit_url: null
---

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"List namespaces"}
>
</Heading>

<MethodEndpoint
  method={"get"}
  path={"/namespace"}
  context={"endpoint"}
>
  
</MethodEndpoint>



List namespaces within an account.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
  children={"Request"}
>
</Heading>

<ParamsDetails
  parameters={[{"in":"query","name":"offset","schema":{"type":"integer","minimum":0},"description":"The starting point for pagination. Defaults to 0 if not provided.","example":0},{"in":"query","name":"limit","schema":{"type":"integer"},"description":"The maximum number of results to return per page.","example":30},{"in":"query","name":"account_id","schema":{"type":"string"},"required":true,"description":"Filters namespaces by account. Supports up to 10 comma-separated values.","example":"123, 345"}]}
>
  
</ParamsDetails>

<RequestSchema
  title={"Body"}
  body={undefined}
>
  
</RequestSchema>

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"type":"object","required":["paging","results"],"properties":{"paging":{"required":["offset","limit","total"],"properties":{"total":{"type":"integer","description":"The total number of results matching the query.","example":30},"offset":{"type":"integer","minimum":0,"description":"The starting point for pagination. Defaults to 0 if not provided.","example":0},"limit":{"type":"integer","description":"The number of results returned per page. Defaults to 30.","example":30}}},"results":{"type":"array","items":{"type":"object","required":["id","name","slug","organization_id","repository_provider","repository_prefix","status","account_id"],"properties":{"id":{"type":"integer","description":"A system-wide unique ID for the namespace.","example":234},"name":{"type":"string","maxLength":60,"description":"The name of the namespace.","example":"Crypto Kong Billing"},"status":{"type":"string","description":"The status of the namespace.","enum":["active","inactive"],"example":"active"},"slug":{"maxLength":60,"type":"string","description":"An account-wide unique slug for the namespace.","example":"crypto-kong-billing"},"account_id":{"type":"integer","description":"The ID of the account that owns this namespace.","example":123},"metadata":{"type":"object","description":"The metadata loaded via metadata catalog API.","example":{"key":"value"},"properties":{"key":{"type":"string","description":"The key of the metadata."},"value":{"type":"string","description":"The value of the metadata."},"additional_properties":{"type":"object","description":"Additional properties of the metadata.","properties":{"schemas":{"type":"array","description":"The schemas of the metadata, in JSON format."},"tags":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"value":{"type":"string"}}}}}}},"title":"MetadataComponent"}},"title":"namespace"}}},"title":"accountListResponse"}}}},"4XX":{"description":"Client error responses due to invalid input or missing parameters.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific client error (e.g., 400, 401, 403, 404).","example":400},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"bad_request"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Bad Request\", \"Unauthorized\").","example":"Bad Request"},"message":{"type":"string","description":"Additional details about the error.","example":"The request was malformed or contained invalid parameters."}}}}}},"5XX":{"description":"Server error responses indicating an issue on the API side.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","error","message"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code representing the specific server error (e.g., 500, 502, 503).","example":500},"code":{"type":"string","description":"A machine-readable error code that categorizes the server failure.","example":"internal_server_error"},"error":{"type":"string","description":"A brief, human-readable description of the error type (e.g., \"Internal Server Error\", \"Service Unavailable\").","example":"Internal Server Error"},"message":{"type":"string","description":"Additional details about the error.","example":"An unexpected error occurred. Please try again later."}}}}}}}}
>
  
</StatusCodes>