---
id: organization-read
title: "Read an organization"
description: "Reads a specific organization by ID."
sidebar_label: "Read an organization"
hide_title: true
hide_table_of_contents: true
api: eJzdV21v2zYQ/isEP7WA4jhve9E3L+02F9satC5WIA2Cs3iW2EqkSlJOXEP/fThSkiVbaDxg64Dlg+2Qx7vnHt4Lb8sF2sTI0kmteMzfIAjLgNkSE7mSCdMmBSW/AO2z5YbNX0x4xHWJxi/NBY95XyY2CIJH3EFqeXzLX/f2+F3ESzBQoENDu1uuoEAec0lHJAEowWU84gY/V9Kg4LEzFUZ7KBcZsvkLplfMZTiE6DQjBATSJhkWwOMtd5uSrFhnpEp5XUed4QIdCHBwL1WSVwJbGJ8rNBu+b/daFwWcWCQnHAqWS+sIRauFlYaYcRItAWl0Mqk8ToO21MrihM3WIHNY5sjWkFdo2W3AaiNGvN0RenyEosw97GbPU/o1t+4ibjGpjHQbT+4SwaCZVS7j8e0dbbcQLB0/n07pa+jiTDG9/IiJYwZLgxaVkyo94JkQJlo5VI50QFnmMvE7px8tKdoe4gx6B5d7G27eX0bEbV6l9OXAVdYHS0cnqZGip0wqhymagyuaMbuxDouTBymQVUp+rnysrLQZdaKj+ccfzi8uzy4uz87rBtABwxEv4PE3VCkR+t10LCoHsUhahld5bTal02yukgmvG4fjbV/t99PowOoTZkjL0EzizZxIlXgrgc8Rdw4VB9mxzPIWVFXQpUHi5DrkSvPzrm++WaujLr3GouDQeJdGuQaBgq0leBjdegIOcp2y2c184PCWf8INj7nPJrI7DBy/eYz3n3DTut7aHBJLmuqosXOUSi/6VaWqyvM64iCEpHOQ3w/Rf523WXdsrApFTQ2iFG7KCAMlfJUhEENLjUTPKBgDh2WQ/Hr19vUfncoR96TDYgR+Xbet4SkbkFoG1upE+lL7IF12rJEj7//4a91JNhEW/iLupPPLvzegrnVRakVFsb/bTyMeDl6+f39Ye69zicoxNEabrltYJioM3WQNuRRMqrJyTBtWSGvpYnct9R+ryqEMXGvfED0eKn5oLaR4WJh70k8X6F8Xi5u2zCRa4GGf6d4eSZ+PZzhJJxG7nE7p44w+Lujj8vkgmy6n05pIEEfk54wVkGRS4Qk9GXw/DrY8LpeBo4qDqTbyC3V0woZmjYatQOaV2SvuSxD3RCJaR9EUaDsCxNJIXEUsqwpQOyQ9qTa/AjhS17Lxgf8Egr0JRj9wWninoHKZhyw+8CE5felQnsONPg1yV2UEOpC5ZbDUldvBGtpZ+OeOt8MewLIC8pU2BQrm2VUOpELRhXQ/gtvUuhrLkLeB/v0MkUr4OFcpA8WktVRyw6NrdjNnVgr8n6WG7RPRBMMVpcbV9Jw+LoYXf/XfZQU5a6irBaH7QNk3y495Y541ofOSZEKm0IpMkL1T0L7HDxJm9Pi/mjozxSqFjyUm1PaCSzpJKmNQTNhNjmCRObNhkIJULAeHZrLrSAW6TNNQlqJvhDROxfy034JOt1LU9M72LoU5rDI5j3nmXGnj01Mo5YSeJWUOjvJ2kuiC98eLt5QqIcL7Q0bHBSlqRxVfGr0Qj5ofP2tTgOMxf/XnwndKqVaajhOeQNvZZDqZ8l0PHcyR9MLT1hXg87YZ5Wh0pfQfdNu929juasCxo27jkcNHd1rmIL11T9e2YfeW75mMpaBKkGnraHe7XYLFdyava1oOoyWRLqSloBM8XkFu96fcPtZvOXiOOhze1yPTcvNm4j481mAkaf+b3j1709TX5+y4yX4UYvucVJs+rBa6FLy+qyOeIQg0HmDYmCUJlq535KA1kGddWv3ycsEjDsNw3wtvr30UznYbJBb6E6q67tA5+p8A1vVfXtcUxQ==
sidebar_class_name: "get api-method"
info_path: docs/api/organization
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 an organization"}
>
</Heading>

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



Reads a specific organization by ID.

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

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

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"An object representing the organization.","content":{"application/json":{"schema":{"type":"object","required":["id","name","slug","status"],"properties":{"id":{"type":"integer","description":"A system-wide unique ID for the organization.","example":9823413412},"name":{"type":"string","maxLength":60,"description":"The organization name.","example":"Crypto Inc."},"slug":{"maxLength":70,"type":"string","description":"The organization slug.","example":"crypto-inc"},"status":{"type":"string","description":"The status of the organization.","enum":["active","inactive"],"example":"active"},"metadata":{"type":"object","description":"The metadata loaded via the metadata catalog API.","example":{"key":"value"},"properties":{"key":{"type":"string","description":"The key of the metadata.","example":"key"},"value":{"type":"string","description":"The value of the metadata.","example":null},"additional_properties":{"type":"object","description":"Additional metadata properties, including schemas and tags.","properties":{"schemas":{"type":"array","description":"The JSON schemas of the metadata.","items":{"type":"object"}},"tags":{"type":"array","description":"Tags associated with the metadata.","items":{"type":"object","properties":{"key":{"type":"string","example":"key"},"value":{"type":"string","example":"value"}}}}}}},"title":"MetadataComponent"}},"title":"organization"}}}},"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>