---
title: "Retrieve company"
method: GET
path: "/companies/{id}"
tags: ["Companies"]
---

# Retrieve company

`GET /companies/{id}`

Retrieves the details of an existing company.

Required permissions:
 - `company:basic:read`

## Path parameters

- `id` string, required

## Response `200`

A successful response

- Company — A company is a seller on Whop. Companies own products, manage members, and receive payouts.
  - `affiliate_instructions` string, nullable, required — Guidelines and instructions provided to affiliates explaining how to promote this company's products.
  - `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.
  - `featured_affiliate_product` object, nullable, required — The product featured for affiliates to promote on this company's affiliate page. Null if none is configured.
    - `id` string, required — The unique identifier for the product.
    - `name` string, required — The display name of the product shown to customers. Maximum 50 characters.
  - `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.
  - `social_links` object[], required — The list of social media accounts and external links associated with this company.
    - `id` string, required — The unique identifier for the social link.
    - `url` string, required — The URL of the social media profile or external link.
    - `website` 'x' | 'instagram' | 'facebook' | 'tiktok' | 'youtube' | 'linkedin' | 'twitch' | 'website' | 'custom', required — The different websites you can have social links for
  - `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.

## 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/866821546d67/schema)