---
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","maximum":200,"description":"The maximum number of results to return per page. The maximum allowed value is 200.","example":200}}},"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>