---
title: "List companies"
method: GET
path: "/companies"
tags: ["Companies"]
---

# List companies

`GET /companies`

Returns a paginated list of companies. When parent_company_id is provided, lists connected accounts under that platform. When omitted, lists companies the current user has access to.

Required permissions:
 - `company:basic:read`

## Query parameters

- `after` string, nullable — Returns the elements in the list that come after the specified cursor.
- `before` string, nullable — Returns the elements in the list that come before the specified cursor.
- `first` integer, nullable — Returns the first _n_ elements from the list.
- `last` integer, nullable — Returns the last _n_ elements from the list.
- `parent_company_id` string, nullable — The unique identifier of the parent platform company. When provided, lists connected accounts under that platform. Omit to list the current user's own companies.
- `direction` 'asc' | 'desc' — The direction of the sort.
- `created_before` string, date-time, nullable — Only return companies created before this timestamp.
- `created_after` string, date-time, nullable — Only return companies created after this timestamp.

## Response `200`

A successful response

- object — The connection type for PublicCompany.
  - `data` CompanyListItem[], required — A list of nodes.
    - `created_at` string, date-time, required — The datetime the company was created.
    - `description` string, nullable, required — A promotional pitch written by the company creator, displayed to potential customers on the store page.
    - `id` string, required — The unique identifier for the company.
    - `logo` object, nullable, required — The company's logo.
      - `url` string, nullable, required — A pre-optimized URL for rendering this attachment on the client. This should be used for displaying attachments in apps.
    - `member_count` integer, required — The total number of users who currently hold active memberships across all of this company's products.
    - `metadata` object, nullable, required — A key-value JSON object of custom metadata for this company, managed by the platform that created the account.
    - `owner_user` object, required — The user who owns and has full administrative control over this company.
      - `id` string, required — The unique identifier for the user.
      - `name` string, nullable, required — The user's display name shown on their public profile.
      - `username` string, required — The user's unique username shown on their public profile.
    - `published_reviews_count` integer, required — The total number of published customer reviews across all products for this company.
    - `route` string, required — URL slug for the account's store page, e.g. `pickaxe` in whop.com/pickaxe.
    - `send_customer_emails` boolean, required — Whether Whop sends transactional emails (receipts, updates) to customers on behalf of this company.
    - `target_audience` string, nullable, required — The target audience for the company. Null if not set.
    - `title` string, required — The display name of the company shown to customers.
    - `updated_at` string, date-time, required — The datetime the company was last updated.
    - `verified` boolean, required — Whether this company has been verified by Whop's trust and safety team.
  - `page_info` PageInfo, required — Information about pagination in a connection.
    - `end_cursor` string, nullable, required — When paginating forwards, the cursor to continue.
    - `has_next_page` boolean, required — When paginating forwards, are there more items?
    - `has_previous_page` boolean, required — When paginating backwards, are there more items?
    - `start_cursor` string, nullable, required — When paginating backwards, the cursor to continue.

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `422` — Verification required
- `429` — Too many requests
- `500` — Internal server error

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/db0883548bc5/schema)