---
title: "Search for accounts"
method: POST
path: "/accounts"
tags: ["accounts"]
---

# Search for accounts

`POST /accounts`

Search for accounts using various filters. No search filters required - empty body returns all results.

## Request body

- object
  - `industry` string — Filter by industry
  - `employee_size_category` string — Filter by employee size category
  - `revenue_category` string — Filter by revenue category
  - `country` string — Filter by country
  - `company_name` string — Filter by company name
  - `page` integer — Page number
  - `per_page` integer — Page size. Default 25, maximum 50 on all list endpoints. Omit to use the default; increase up to 50 only if you need larger pages.
  - `public_company` boolean — Filter by public company status
  - `offset` integer — Offset for pagination

## Response `200`

Success

- AccountsSearchResponse — Response from accounts search endpoint
  - `request` object — Request parameters used for the search
    - `industry` string, nullable
    - `employee_size_category` string, nullable
    - `revenue_category` string, nullable
    - `country` string, nullable
    - `public_company` boolean
    - `company_name` string, nullable
    - `page` integer
    - `per_page` integer
  - `items` AccountItem[], required — Array of company/account items
    - `id` string, uuid, required
    - `company_name` string
    - `domain` string
    - `website` string, uri
    - `public_company` boolean
    - `industry` string, nullable
    - `employee_size_category` string, nullable
    - `revenue_category` string, nullable
    - `country` string, nullable
    - `company_id` string, uuid, required
    - `website_domain` string
    - `country_code` string, nullable
    - `linkedin_url` string, uri, nullable
    - `hq_city` string, nullable
    - `hq_state` string, nullable
    - `hq_address` string, nullable
    - `hq_postcode` string, nullable
    - `hq_country_name` string, nullable
    - `region` string, nullable
    - `ceo` string, nullable
    - `sector` string, nullable
    - `revenue_range` string, nullable
    - `employee_count_range` string, nullable
    - `full_time_employees` integer, nullable
    - `alternative_domains` string[], nullable
    - `alternative_names` string[], nullable
    - `tags` string[], nullable
    - `description` string, nullable
    - `stock_ticker` string, nullable
    - `market_cap` number, nullable
    - `stock_currency` string, nullable
    - `stock_exchange_name` string, nullable
    - `stock_exchange_symbol` string, nullable
  - `pagination` Pagination, required — Pagination information
    - `page` integer, required — Current page number
    - `per_page` integer, required — Items per page
    - `total` integer, nullable — Total number of items
    - `total_items` integer, nullable — Total number of items (alternative field name)
    - `total_pages` integer — Total number of pages
    - `has_next` boolean, nullable — Whether there is a next page
    - `has_previous` boolean, nullable — Whether there is a previous page

## Other responses

- `400` — Input Error. Check the request payload for issues.
- `401` — Unauthorized
- `403` — Access denied. Additional privileges are needed.
- `404` — Not Found. The requested resource does not exist.
- `429` — Rate Limited. Too many requests.
- `500` — Unexpected error

---

[API](https://skmtc.net/getpg/apis/pg-ai-public-api.md) · [All operations](https://skmtc.net/getpg/apis/pg-ai-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/getpg/pg-ai-public-api/revisions/cc47d013c073/schema)
