---
id: namespace-read
title: "Read a namespace"
description: "Read a specific namespace by ID."
sidebar_label: "Read a namespace"
hide_title: true
hide_table_of_contents: true
api: eJzdV21v2zYQ/isEP7WA4rh52Qd9c9NuS7d1QetiBdIgOItniQ1FqiTlxjX034cjJVm21SQD9gLMH2RbJO+ee+6Nt+ECXWZl5aXRPOXvEAQD5irM5FJmTEOJroIM2WLNLl9NeMJNhRZo+6XgKe83pBZB8IR7yB1Pr/nbboHfJLwCCyV6tLS0CYd4ykv0IMDDrdSZqgXyhEsC8aVGu+bJHrQLU5Zw5JBkeRRMSeeZWbJOCqssQfMSHfOGtTKZ1MwXyCy6ymiHEzZbgVSwUMhWoGp07NplBZbgEkbYb8hGvIeyUoSxWwtmJe1fnm64X1dh3Vupc940ySaCr8AXPOlMlGLskNQec7S8SbjFL7W0KHjqbY37Ns8LZJevyEqyoed6B+LJ6dl5c5Nwh1ltpV8HhhcIFu2s9gVPr29ouSPAEY6T6ZS+DpX1zmVfwTFXZxk6t6wVacyM9qg9HYSqUjILG48/Ozq9ObTSLD5j5vnQxutISCAn4U7VOQWUzUHLb0HabVi3WBknvbHr28qalRRo99/iUt6TCA++JsdAlplaezpP8daHAuGRYoT7fapnzK2dx/LoqxTIai2/1IH7pbEPk990zt6PiYSXcP8r6pyc8MN0zLd08GHv8gu7rrxhvxids5dSqRBtveEjSg+1xL3jenRdklsg83IVE7D9eTME0b5rWp+lm33THgYx06z1zw67JOsRfnkWzD+6Mzo/WmzNH7j7cdfuZlF7lPkCPDNftWO+kO47+l+cnDZJX6jGgvtQVV+QlAGBgq0kbN9l4EGZnM2uLncUbfgdrnnKQ00iC3dDOCw+xdd3uO4M7XROSFyU+yQRYeuoEBBC0kZQt7vwHiZl1h8b1ugDBfs2t6V3IB+shcPGEEI87t0XmlD5f/P+97cUZiX4YEXsUAdCpcdy1JgneOL7BDfxk3AvfQjo31poF6asjKZ6Olzto5DHU2cfPx4W6gslUXuG1hrbNzbHRI2x8a1AScGkrmrPjGWldE7qnG2b8N9WzWNluTChdwc8VPXQOcjxsA4Pdj+etD/P51dd5cqMoA5eWXSoPdlCTu4vKdmQj2c4yScJO5tO6fGCHqf0OHu+k29n02lDJIgnJMWMlZAVUuMR3XHC1SHqCrhCHcnAY26s/EaXD8KGdoWWLUGq2u6VtAWIWyIRnafAibQ9AcTCSlwmrKhL0Fskg11d9EdwJK5j4xN/CYK9i0o/cXrxQUPtiwBZfOK75Ax382br0cdBbjNdoAepHIOFqf0W1q6eebiZBT3hwlGCokRFwQK72oPUKPqQHkZwl1fnYxnyPtK/nyFSixDnOmegmXSO6ly8H86uLpmTAv9nqeGGRLTBcE6pcT49ocfpruPP/7usIGMtdZa46TZS9q/lx2WrnrWh85r2xEyhNzJD9kFDNzocJMzo8X80dWaa1RrvK8xoGIommSyrrUUxYVcKwSHzds0gB6mZAo92sm1HJfrC0ACXY+hxNLWk/LjvP8cbKRq6YAd74thWW8VTXnhfufT4GCo50bVSlQJPSTvJTMmHg8h7ypMY3sNxpCeCBHXTUaiLYRNP2h8/ho7NU/7mj3nokVIvDR0nPJGzF5PpZMq33XM7c9IFyjhfQsjYdhhrh9ttj93zwWab+U8ZhFszPN7740qB1KQ1cLRp+bzmQ11pnE0K4zwtbTYLcPjBqqah13HoJZqFdBRjgqdLUG5/JhyC/DdH4lFr4511ZI5vb0M8BMQKrCTpf9G6Z+/acvqcPTAHj+LqrnZ6PcTS4ZWCNzdNwgsEmiwJVVyYZRlWfnDkoPyTOX3q/PR6TpPnblTvRXGQPgpns4k75uYOddP06Dz9J4BN8yeSyhY1
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={"Read a namespace"}
>
</Heading>

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



Read a specific namespace by ID.

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

<ParamsDetails
  parameters={[{"name":"metadata_include","in":"query","description":"Comma-separated list of metadata properties to include in the response. Available values [schemas, tags].","example":"schemas,tags","schema":{"type":"string"}},{"in":"path","name":"id","schema":{"type":"integer"},"required":true,"description":"The ID of the namespace.","example":2345}]}
>
  
</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":["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"}}}},"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>