---
id: account-read
title: "Read an account"
description: "Reads a specific account."
sidebar_label: "Read an account"
hide_title: true
hide_table_of_contents: true
api: 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
sidebar_class_name: "get api-method"
info_path: docs/api/account
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 account"}
>
</Heading>

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



Reads a specific account.

<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 account.","example":1234},{"in":"query","name":"show_deleted","schema":{"type":"boolean","default":false},"required":false,"description":"When `true`, returns the account even if it has been soft-deleted.\nSoft-deleted accounts are identified by a non-null `deleted_at`\ntimestamp in the response. Defaults to `false`, in which case\nsoft-deleted accounts respond with `404 Not Found`.\n","example":true}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"An object representing the account.","content":{"application/json":{"schema":{"type":"object","required":["id","name","slug","organization_id","status"],"properties":{"id":{"type":"integer","description":"A system-wide unique ID for the account.","example":1234},"name":{"type":"string","maxLength":60,"description":"The account name.","example":"Crypto Kong"},"slug":{"type":"string","maxLength":70,"description":"An organization-wide unique slug for the account.","example":"crypto-kong"},"organization_id":{"type":"integer","description":"The ID of the organization that owns this account.","example":123},"status":{"type":"string","enum":["active","inactive","deleted"],"description":"The status of the account. The `deleted` value is only returned in\nresponses to `GET /account/{id}?show_deleted=true` for accounts\nthat have been soft-deleted; it cannot be set via create or update.\n","example":"active"},"deleted_at":{"type":"string","format":"date-time","nullable":true,"description":"The timestamp at which the account was soft-deleted, or `null` if\nthe account is still active. Only populated in responses to\n`GET /account/{id}?show_deleted=true`.\n","example":"2026-05-15T12:34:56.000Z"},"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":"account"}}}},"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":"Internal server error due to an unexpected issue.","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>