---
title: "List accounts"
method: GET
path: "/account"
tags: ["Account"]
---

# List accounts

`GET /account`

Lists accounts within an organization.

## Query parameters

- `offset` integer
- `limit` integer
- `organization_id` string, required

## Response `200`

The list of accounts matching the query.

- AccountListResponse
  - `paging` object, required
    - `total` integer, required — The total number of results matching the query.
    - `offset` integer, required — The starting point for pagination. Defaults to 0 if not provided.
    - `limit` integer, required — The maximum number of results to return per page. The maximum allowed value is 200.
  - `results` Account[], required
    - `id` integer, required — A system-wide unique ID for the account.
    - `name` string, required — The account name.
    - `slug` string, required — An organization-wide unique slug for the account.
    - `organization_id` integer, required — The ID of the organization that owns this account.
    - `status` 'active' | 'inactive' | 'deleted', required — The status of the account. The `deleted` value is only returned in responses to `GET /account/{id}?show_deleted=true` for accounts that have been soft-deleted; it cannot be set via create or update.
    - `deleted_at` string, date-time, nullable — The timestamp at which the account was soft-deleted, or `null` if the account is still active. Only populated in responses to `GET /account/{id}?show_deleted=true`.
    - `metadata` MetadataComponent — The metadata loaded via the metadata catalog API.
      - `key` string — The key of the metadata.
      - `value` string — The value of the metadata.
      - `additional_properties` object — Additional metadata properties, including schemas and tags.
        - `schemas` object[] — The JSON schemas of the metadata.
        - `tags` object[] — Tags associated with the metadata.
          - `key` string
          - `value` string

## Other responses

- `4XX` — Client error responses due to invalid input or missing parameters.
- `5XX` — Internal server error due to an unexpected issue.

---

[API](https://skmtc.dev/nullplatform/apis/nullplatform-api.md) · [All operations](https://skmtc.dev/nullplatform/apis/nullplatform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nullplatform/nullplatform-api/revisions/1c4ea154b159/schema)