---
id: dimension-read
title: "Read a dimension"
description: "Read a dimension by its ID."
sidebar_label: "Read a dimension"
hide_title: true
hide_table_of_contents: true
api: eJzdV21v2zYQ/ivEfUoB1XHe9iIgH7y227IPRZCmWIE0CM7iWbpWIlWScuoa+u/DUfK7MWdouwH7IsvU8e65h/eQvDlo8pnjOrA1kMINoVaoNFdkPFujxjPFwaurlwNIwNbkUCyvNKSwNEodoYYEAuYe0jt4ufgA9wl4yhrHYQbp3RzGhI7cqAkFpHf37X0CNTqsKJDz0YAFRI2hgAQMVgQpsLj2WUEVQjqHMKvjqAmUk4M2AUefGnakIQ2uoWQro9uC1NVLZScqFLRKTNKhz1jVJUF6cnp2LmAc+doaT14CnQ6H8rPrbcmCekSvfJNl5P2kKcVlZk0gE2Qi1nXJWTQ8/uBl9nw3DTv+QFmABGonbgN3sVnvSXU7s5HyMx+oev7ImlRj+FMTU3VUO/JkApv8UNILlpfBfHBs8p1YkrdY7vC47hFemSk7ayphoE3ABwyNf5rzzrZzz34LsmkqqSvMAk8JEmDTv96vR+/HJHDZ5IfDjmJGzzU5npJWndVT2QPazNU4czji65vX6giDsk6NqbSPz9RjQY42w6hYOOQ3w1mXo+EvsZwuT1LMMtuYcHmaSg6+xowuz9K1krs8F1TWaXJ7S6liw5XQerJvNWrHVkS7tRiqQC+QDU3JKdeYwBWpzJoJ502viSmWDXmFjlRFLietjkr7SE7VjkoM5FXBeUFOmaYak/PPNouyTaDzsE8ku0AX0abIJY5LUhPr9lTQ91RXhLCRxM8//fjD1ytrj2N4EzAXJ18nrv0Lty/w9xLeQa3tS96vkv+GaouBvp3m2gQChzi9p/lhg+aHZeSHGPmfzIC2Fevzd+92D6YXJZMJipyzTi3PMaUbUsEqNlMsWSs2dRMJqdh7IX11/H7V6bU6gu/6wnxhtRRMxCPbDXmPeaybTS2uWR/W5O+3t9eLYs6spt0C8jVlPOFMZet8HNEgHyTqfDiUx4k8zuRxvrn5nA+HrZCgnyDbkaowK9jQc7n8xK2nixVxhQKDyjBQbh1/Id9hIyfb5gS5bNxWbY9RPwiJ5ONp0tH2BBBjxzRJVNFUaFZI1qwW20oHTtwt2HgPv6BWN13Q9yADbw02oYiQ9XvYJGfdWiAuVvQwSK1ZXrFUmgJy6RWObRNWsDbjyIbVUxEvWBWWE+sq0iqyawKyIb0s6fUKbttOIRf7FPKmo39bIWx0rHOTKzSKvW9IWRPBja6vlGdN/zNp+HUi+mK4EGlcDE/lcba58Bf/nSokWWewfOiMHjrK/jV9XPXhVV86r8SmU4qMcEbqrVlePXYEs3f6d5XOyKjG0OeaskC6T8lmWeMc6YG6Lgk9qeBmCnNko+Q65haqibhCYaWzyym2JNKGpXC8PH+O56xbacZiPl3D1rgSUihCqH16fIw1D0xTlnWJQUQ7yGwF7VoX+EZ00pX3ei+4JEIcLdq9uC9GI0j6l1+tqzBACn/8eRtPTjYTK9MFT8fZyWA4GMLqTF02o16or60PFUbJ9u3ldse7vQjzlfQPdMd9CoE+h+O6RDYSMPIz77m8g/UwKWsRfWF9kE/z+Rg9vXVl28rwp4acNM33ciF2LBUWCdfs5V1DOsHSb7e762iPbvqt55n6myZ4L+p+EM0M+vs4pAAJfKRZ15G3920CBWFsL+7m/YdRllEd1qbsbJVSC8sy++3VLSSAmxWwteLR+14483lncWs/kmnbJbog/wVg2/4FJ2fapw==
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={"Read a dimension"}
>
</Heading>

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



Read a dimension by its ID.

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

<ParamsDetails
  parameters={[{"in":"path","name":"id","schema":{"type":"integer"},"required":true,"description":"The ID of the dimension.","example":1234}]}
>
  
</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","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"}}}},"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>