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

# List companies

> Returns a paginated list of companies for the authenticated organization.



## OpenAPI

````yaml openapi.json get /v/alpha/companies/list
openapi: 3.1.0
info:
  title: Operate API Documentation
  description: 'API for Operate: A CRM designed for sales, built for founders'
  version: Alpha
servers:
  - url: https://api.operate.so
security:
  - apiKey: []
tags:
  - name: Companies
    description: Manage companies and their associated data
  - name: People
    description: Manage people/contacts and their associated data
  - name: Deals
    description: Manage deals and opportunities
  - name: Feedback
    description: Manage customer feedback and feature requests
  - name: Next Steps
    description: Manage action items and next steps
  - name: Profiles
    description: Manage organization profiles (team members)
paths:
  /v/alpha/companies/list:
    get:
      tags:
        - Companies
      summary: List companies
      description: >-
        Returns a paginated list of companies for the authenticated
        organization.
      operationId: getVAlphaCompaniesList
      parameters:
        - name: limit
          in: query
          required: false
          schema:
            minimum: 1
            maximum: 100
            default: 50
            description: Maximum number of companies to return per page (1-100)
            examples:
              - 10
              - 25
              - 50
            type: number
        - name: offset
          in: query
          required: false
          schema:
            minimum: 0
            default: 0
            description: >-
              Number of companies to skip for pagination. Use with limit to
              paginate through results.
            examples:
              - 0
              - 50
              - 100
            type: number
      responses:
        '200':
          description: Successful response
components:
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication. Obtain from your Operate dashboard.

````