> ## Documentation Index
> Fetch the complete documentation index at: https://docs.whop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Products

> Returns a paginated list of products belonging to a company.



## OpenAPI

````yaml /openapi/api-v1-native.yml get /products
openapi: 3.1.0
info:
  title: Whop API
  description: >-
    Hand-written V1 endpoints. Merged into the GraphqlRestProxy-generated schema
    at build time.
  version: v1
servers:
  - url: https://{defaultHost}
    variables:
      defaultHost:
        default: api.whop.com/api/v1
security: []
paths:
  /products:
    parameters:
      - $ref: '#/components/parameters/ApiVersionDate'
    get:
      tags:
        - Products
      summary: List Products
      description: Returns a paginated list of products belonging to a company.
      operationId: listProducts
      parameters:
        - name: company_id
          in: query
          schema:
            type: string
          required: true
          description: The unique identifier of the company to list products for.
        - name: visibilities
          in: query
          schema:
            type: array
            items:
              type: string
          required: false
          description: Filter to only products matching these visibility states.
        - name: access_pass_types
          in: query
          schema:
            type: array
            items:
              type: string
          required: false
          description: Filter to only products matching these types.
        - name: direction
          in: query
          schema:
            type: string
            enum:
              - asc
              - desc
          required: false
          description: The sort direction for results. Defaults to descending.
        - name: order
          in: query
          schema:
            type: string
          required: false
          description: The field to sort results by. Defaults to created_at.
        - name: first
          in: query
          schema:
            type: integer
          required: false
          description: The number of products to return (default and max 100).
        - name: after
          in: query
          schema:
            type: string
          required: false
          description: A cursor; returns products after this position.
        - name: last
          in: query
          schema:
            type: integer
          required: false
          description: The number of products to return from the end of the range.
        - name: before
          in: query
          schema:
            type: string
          required: false
          description: A cursor; returns products before this position.
      responses:
        '200':
          description: products listed
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/ProductListItem'
                  page_info:
                    type: object
                    properties:
                      end_cursor:
                        type:
                          - string
                          - 'null'
                      start_cursor:
                        type:
                          - string
                          - 'null'
                      has_next_page:
                        type: boolean
                      has_previous_page:
                        type: boolean
                    required:
                      - end_cursor
                      - start_cursor
                      - has_next_page
                      - has_previous_page
                required:
                  - data
                  - page_info
        '400':
          $ref: '#/components/responses/InvalidParameters'
          description: missing company_id
        '401':
          $ref: '#/components/responses/Unauthorized'
          description: missing or invalid authentication
      security:
        - bearerAuth:
            - product:basic:read
components:
  parameters:
    ApiVersionDate:
      name: Api-Version-Date
      in: header
      required: false
      schema:
        type: string
        format: date
        example: '2026-06-20'
      description: >-
        Pins the request to a dated API version. When omitted, the request uses
        the original (2025-01-01) request/response shapes, so existing
        unversioned callers are never broken. Generated SDKs always send the
        latest version they were built against. An unrecognized value is
        rejected with a 400. The schemas documented here always describe the
        latest version.
  schemas:
    ProductListItem:
      type: object
      properties:
        id:
          type: string
          description: Product ID, prefixed `prod_`.
        created_at:
          type: string
          description: When the product was created, as an ISO 8601 timestamp.
        updated_at:
          type: string
          description: When the product was last updated, as an ISO 8601 timestamp.
        title:
          type:
            - string
            - 'null'
          description: Product display name shown to customers.
        visibility:
          type:
            - string
            - 'null'
          description: Whether the product is publicly visible, hidden, or archived.
        headline:
          type:
            - string
            - 'null'
          description: Short marketing headline displayed on product page.
        verified:
          type: boolean
          description: Whether the product has been verified by Whop.
        member_count:
          type: number
          description: >-
            Active memberships for this product; 0 if public member counts are
            disabled.
        route:
          type:
            - string
            - 'null'
          description: URL slug for the product's public link.
        published_reviews_count:
          type: number
          description: Published customer reviews for this product.
        external_identifier:
          type:
            - string
            - 'null'
          description: External identifier stored on the product for your own reference.
        metadata:
          type:
            - object
            - 'null'
          description: Custom key-value pairs stored on the product.
      required:
        - id
        - created_at
        - updated_at
        - title
        - visibility
        - headline
        - verified
        - member_count
        - route
        - published_reviews_count
        - external_identifier
        - metadata
    V1ErrorResponse:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              description: Machine-readable error code.
            message:
              type: string
              description: Human-readable error message.
          required:
            - type
            - message
      required:
        - error
  responses:
    InvalidParameters:
      description: Invalid Parameters
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/V1ErrorResponse'
    Unauthorized:
      description: Unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/V1ErrorResponse'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: auth-scheme
      description: >-
        An account API key, account scoped JWT, app API key, or user OAuth
        token.

````