---
id: dimension-list
title: "List dimensions"
description: "List dimensions by NRN."
sidebar_label: "List dimensions"
hide_title: true
hide_table_of_contents: true
api: eJzdWG1v2zYQ/isHfkoB1XHe9iKgH7K+bBmGoEhTrEAaBGfxLLGVSJWknLiG/vtwlGRbtuYka7MB+6I4Enn38Ll7yOMthCSXWFV6ZbSIxR/KeZCqIO2U0Q4mczi/OB+JSJiSLPKoMylisRwS58p5EQmPqRPxlXjVfRDXkSjRYkGeLH9aCMUevlRk5yISGgsSsTDTqSM24JKMChTxQvh5yV+U9pSSFZEolFZFVYh4HAlJU6xyL+JxHW1gv8wInEfrlU6hNEp7mBoLJaZKB+QjeNXMduANjEFNQRsPpTUzJUnyKukOizKnYH4YcK4KtRPvIK4C73gJoKtiQhbMFCy5DoklX1kNJQWw1MNxtA1ky7PzVumUHVv6UilLUsTeVrTErK0Wm6jeqNyTHY710rswNkWtvgb6XhzEmCSm0v7FYcyWXYkJvTiKsSxzlTRjjkV9HQlHSWWVn4ewTwgt2dPKZyK+uubPllxptCPHizgcj/nPNmfLjINbdOCqJCHnplXOCBOjPWnPE9e8739yPHuxRlFp2YxXja+QC+kadWbyiRIO54q5q1VOdrH2xmMeErpnrXk9lLHbiwljB8JfoE8yTlifEYQIb4W/w3O/NJ5SDS0ZD1vt9jqbHCe5yvKe+6Px5rLrkM5h8ppTtBZZA8pT4Ybi2I+Qkg8AfApu7jwVz2+VJKi0+lIRnL0CS6UlR9p34VlqpYf14PDouO6ktqnJQXKwIKamZ7Knutd6pqzRBWd4HQnn0VfuYcabsY155TYga86UK4GJVzNiFnX783rde/uOHedVer/b07Ci55KsmpGEZtRD2RPUXytvVfd6PL84hz30YCxMKDe3z+A2I0t9NxA2BnLfvqFFwlhJdrcAD4aiUVpleB/cCAZk6BiyphlZsJX2qiBIjJ6qtGr3vBnmFTlAS1CQTUnCXm5uWTyWcvTkIFNpRrbVmnvWT8o6Eo2FIZFsA+28zVDlOMkp7BXbGfSU6goQeov4+acff/h2ZQ0YFu98cxB8m7iGAzfk+KmEd6/WhhbvVov/jmoLjr6f5upIeOXD9Jbmmx7NN0vPN8HzY2aI+jHmQ4FbhynHHz5slyovc0XaA1lrLCwrG5AVH/qg9AxzJUHpsgoUFsq5cCQva+NH1TO76pYmPV8aySkW8PAGRc5hStvVy9ro+1X82+Xl2y79EyNpO+VcSYmaqgSSdT72aJSOIjgej/lxwI8jfhz3t6vjMVcYSR/L32Z9gVwy0XNLKMNm1fgKuHyGHhL0lBqrvpJrsJHljXaKKq/shhomKG+YRHLh/GloewCIiVU0jSCrCtQrJGujuo2oAcfmOjY+il9QwkXj9KPgF+81Vj4LkOVH0SdnfTRD7CJ6P0gpFf/EHCR5VLkDnJjKr2D1/fAW11IRSu4C86mxBUkI7GqPiiu4LqXXM7iuG4WcDCnkXUP/pkKUliHPdQqoQTlXERgdwJ2+PQOnJP3PpOHWiWiT4YSlcTI+5MdRP/An/50qeLFWY37TDLppKPvX9HHWuoc2dV7zmEYp/EYlBO/1sljZEszg9CeVzqmGStNdSYkn2S7JJEllLckRvM0JHYG3c8AUlQYu4GynmoDLZ4b7Kmm4d5bId2Wxv347aALRNFIqm4tYZN6XLt7fx1KNdJXnZY6e9TpKTNG7hb9jiTSZvX4XX3LAhrq+QtgSwyARtT/eGFugF7H4/c/LcMwqPTU8nfE0dB2MxqOxWJ2pyy6QY9ZL43yBQa1tQ2KjzbRJ/2Il+h0dqRa9pzu/X+aoNPsK1CxaBq9WfSoWeWac55eLxQQdvbd5XfPrpq/CvErlOJ+kiKeYO9qB6nvcrgfxf6b5elesqW1iIbgL9Dh4j2057YDT9UH+IZq9i3Ynfga7uk47ADQNrJX7a/7HKvYfekqRyAjDFe1q0U45TRIq10FvHR5sZSm8X19fikhgXxgbQgjWu0aEnq/ZXiyaEZfmM+m6Fh1uz/+L+rqu678Aq35zAA==
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","description":"The number of results returned per page. Defaults to 30.","example":30}}},"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>