---
title: "List Accounts"
method: POST
path: "/v1/accounts/list"
tags: ["Accounts"]
---

# List Accounts

`POST /v1/accounts/list`

Returns a paginated list of accounts.

## Request body

- AccountListRequest
  - `filters` union — Filters to apply. Accepts either a flat list of filter rules, implicitly ANDed together, or a recursive filter expression with 'operator' and 'filters'. When an expression omits 'operator', it defaults to 'and'. Filter field names, their valid operators, and allowed values come from GET /v1/schemas/{entity} — each field lists 'allowed_operators' and 'enum_field_settings.allowed_values'. Custom fields are keyed 'custom_field_<uuid>'; related-entity custom fields use '<relation>.custom_field_<uuid>' and are filter-only.
    - FilterRule[]
      - `field` string, required
      - `condition` string, required
      - `value` unknown
    - FilterExpression — A filter expression with an explicit operator. Contains filters that can be either FilterRule objects (leaf nodes) or nested FilterExpression objects (branch nodes), allowing for arbitrarily nested filter structures.
      - `operator` 'and' | 'or' — Logical operators to combine filters or filter expressions.
      - `filters` union[]
        - union
          - FilterRule
            - `field` string, required
            - `condition` string, required
            - `value` unknown
          - FilterExpression — recursive
  - `page` integer — Page number (1-indexed)
  - `page_size` integer — Number of results per page
  - `sort` string — Field to sort by. Prefix with '-' for descending order.
  - `include_custom_fields` boolean — Whether to include custom fields (`custom_field_<uuid>` keys) on each returned account. Defaults to true. Set false to omit them for leaner responses; GET /v1/accounts/{account_id} always returns them.

## Response `200`

Successful Response

- PublicListResponseAccountResponse
  - `data` AccountResponse[], required
    - `id` string, required — Unique identifier for the account
    - `name` string, nullable — Name of the account
    - `status` string, nullable — Current status of the account
    - `owner` OwnerInfo
      - `id` string, required — Unique identifier of the user
      - `first_name` string, nullable — First name of the user
      - `last_name` string, nullable — Last name of the user
    - `notes` string, nullable — Notes about the account
    - `company` CompanyInfo
      - `domain` string, nullable — Primary website domain
      - `linkedin_url` string, nullable — LinkedIn company page URL
      - `description` string, nullable — Company description
      - `employee_count` integer, nullable — Number of employees
      - `founded_year` integer, nullable — Year the company was founded
      - `industries` string[] — List of industry classifications
      - `total_funding_usd` number, nullable — Total funding raised in USD
      - `last_funding_date` string, nullable — Date of the most recent funding round
    - `scoring` ApiPublicApiSchemasAccountsScoringInfo
      - `tier` string, nullable — Firmographic tier
      - `heat_score` string, nullable — Heat score tier
    - `tags` string[] — List of tag names associated with the account
    - `created_at` string, date-time, required — Date and time the account was created
    - `updated_at` string, date-time, required — Date and time the account was last updated
  - `pagination` PaginationInfo, required
    - `page` integer, required — Current page number
    - `page_size` integer, required — Number of results per page
    - `total_count` integer, required — Total number of matching records
    - `total_pages` integer, required — Total number of pages
  - `meta` ResponseMeta
    - `timestamp` string, date-time — Server timestamp of the response

## Other responses

- `4XX` — Client error

---

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