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

# List companies

> Lists companies for the authenticated partner tenant. Supports free-text search, filtering by customer, and pagination (page size capped at 100).



## OpenAPI

````yaml /api-reference/openapi.json get /v1/partner/companies
openapi: 3.1.0
info:
  title: doola Partner API
  description: >-
    REST API for doola partners to create and manage customers and companies,
    retrieve formation documents, and look up reference data.


    Authenticate every request with a partner API key in the `Authorization`
    header. Generate keys and manage webhooks and event subscriptions in the
    doola Partner Portal.
  contact:
    name: doola
    url: https://www.doola.com
  version: v1
servers:
  - url: https://api.test.doola.com
    description: Sandbox — use test keys (dk_test_…)
  - url: https://api.doola.com
    description: Production — use live keys (dk_live_…)
security:
  - PartnerApiKey: []
tags:
  - name: Playground (sandbox only)
    description: >-
      Sandbox-only helpers to drive a test company through the Formation and
      EinCreation milestones end to end.
  - name: Customers
    description: Create and look up customers under your partner tenant.
  - name: Documents
    description: List and download a company's formation documents.
  - name: Signatures
    description: Request embedded signing sessions for pending company documents.
  - name: Companies
    description: Create companies for your customers, then track formation status.
  - name: Reference data
    description: >-
      Static lookups for building company-creation requests: NAICS codes,
      states, countries, and state filing fees.
paths:
  /v1/partner/companies:
    get:
      tags:
        - Companies
      summary: List companies
      description: >-
        Lists companies for the authenticated partner tenant. Supports free-text
        search, filtering by customer, and pagination (page size capped at 100).
      operationId: listCompanies
      parameters:
        - name: q
          in: query
          description: Free-text search over company name.
          required: false
          schema:
            type: string
        - name: customerId
          in: query
          description: Filter to companies owned by this doola customer ID.
          required: false
          schema:
            type: string
        - name: page
          in: query
          description: Zero-based page index.
          required: false
          schema:
            type: integer
            format: int32
            default: 0
            minimum: 0
        - name: size
          in: query
          description: Page size (max 100).
          required: false
          schema:
            type: integer
            format: int32
            default: 20
            minimum: 1
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: >-
                  #/components/schemas/PartnerSearchPagePartnerCompanyListItemDto
components:
  schemas:
    PartnerSearchPagePartnerCompanyListItemDto:
      type: object
      properties:
        content:
          type: array
          items:
            $ref: '#/components/schemas/PartnerCompanyListItemDto'
        page:
          type: integer
          format: int32
        size:
          type: integer
          format: int32
        total:
          type: integer
          format: int64
        totalPages:
          type: integer
          format: int32
    PartnerCompanyListItemDto:
      type: object
      description: A company as it appears in a list response.
      properties:
        doolaCompanyId:
          type: string
          description: doola company ID (KSUID).
        doolaCustomerId:
          type: string
          description: Owning doola customer ID (KSUID).
        name:
          type: string
          description: Company name.
          example: Acme Labs LLC
        state:
          type: string
          description: State of formation.
          example: DE
        formationSubmissionStatus:
          type: string
          description: Formation submission status.
  securitySchemes:
    PartnerApiKey:
      type: apiKey
      description: >-
        Partner API key. Send the raw key as the `Authorization` header value —
        e.g. `dk_test_…` in sandbox or `dk_live_…` in production. Generate and
        rotate keys in the doola Partner Portal.
      name: Authorization
      in: header

````