---
id: account-list
title: "List accounts"
description: "Lists accounts within an organization."
sidebar_label: "List accounts"
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={"List accounts"}
>
</Heading>

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



Lists accounts within an organization.

<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","name":"organization_id","schema":{"type":"string"},"required":true,"description":"The ID of the organization for which accounts are being listed.","example":"123"}]}
>
  
</ParamsDetails>

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

<StatusCodes
  id={undefined}
  label={undefined}
  responses={{"200":{"description":"The list of accounts matching the query.","content":{"application/json":{"schema":{"type":"object","required":["paging","results"],"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","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"}}},"title":"accountListResponse"}}}},"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>