---
id: dimension-list
title: "List dimensions"
description: "List dimensions by NRN."
sidebar_label: "List dimensions"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/dimensions
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 dimensions"}
>
</Heading>

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



List dimensions by NRN.

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

<ParamsDetails
  parameters={[{"in":"query","name":"offset","schema":{"type":"integer","minimum":0,"default":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","schema":{"type":"string"},"required":true,"name":"nrn","description":"Filter dimensions by NRN.","example":"organization=1:account=2:namespace=3:application=4"}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The operation was successful.","content":{"application/json":{"schema":{"properties":{"paging":{"type":"object","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","properties":{"id":{"type":"integer","description":"A system-wide unique ID representing the dimension.","example":1234},"name":{"type":"string","description":"The name of the dimension","example":"Environment"},"status":{"type":"string","description":"The status of this dimension.","enum":["active","inactive"],"example":"active"},"slug":{"type":"string","description":"A name-derived string representing the dimension.","example":"environment"},"nrn":{"type":"string","description":"NRN (at or below) where the dimension applies.","example":"organization=1:account=2:namespace=3:application=4"},"order":{"type":"integer","minimum":1,"description":"The priority this dimension has whenever runtime configuration values are merged (lower prelates higher numbers).","example":1},"values":{"type":"object","description":"The values available for this dimension.","properties":{"id":{"type":"integer","description":"A system-wide unique ID representing the value.","example":9876},"name":{"type":"string","description":"The name of the dimension value.","example":"Staging"},"status":{"type":"string","description":"The status of this runtime configuration dimension value.","enum":["active","inactive"],"example":"active"},"slug":{"type":"string","description":"A string representing the dimension value.","example":"staging"},"nrn":{"type":"string","description":"NRN (at or below) where the dimension value applies.","example":"organization=1:account=2:namespace=3:application=4"}},"title":"runtime_configuration_dimension_value"}},"title":"runtime_configuration_dimension"}}},"title":"runtime_configuration_dimension_list"}}}},"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>