---
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","maximum":200,"description":"The maximum number of results to return per page. The maximum allowed value is 200.","example":200}}},"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>