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

# List companies

> Draft contract for listing companies a credential can access.

**Coming soon — unavailable in sandbox and production.** The code sample uses the current Partner API host for illustration; the final hostname and contract are undecided. Do not send requests to this route.

Results would include only credential-authorized companies. Each proposed Company object contains only `id` and `name`.


## OpenAPI

````yaml GET /v1/companies
openapi: 3.1.0
info:
  title: Ignite Partner API proposed endpoints
  version: draft
  description: Documentation preview only. These operations are not implemented.
servers:
  - url: https://sandbox-api.ignitehealth.com
    description: Ignite sandbox (route not available)
  - url: https://api.ignitehealth.com
    description: Ignite production (route not available)
security: []
paths:
  /v1/companies:
    get:
      summary: List companies
      description: Proposed endpoint. Not available in any environment.
      parameters:
        - name: companyId
          in: query
          required: false
          description: Optional exact ID filter.
          schema:
            type: string
        - name: name
          in: query
          required: false
          description: Optional case-insensitive partial match.
          schema:
            type: string
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 100
            default: 50
        - name: offset
          in: query
          required: false
          schema:
            type: integer
            default: 0
      responses:
        '200':
          description: Proposed authorized companies.
          content:
            application/json:
              schema:
                type: object
                properties:
                  companies:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                      required:
                        - id
                        - name
                  pagination:
                    $ref: '#/components/schemas/Pagination'
                required:
                  - companies
                  - pagination
              examples:
                example:
                  value:
                    companies:
                      - id: company_example
                        name: Example Home Care
                    pagination:
                      limit: 50
                      offset: 0
                      total: 1
      security:
        - bearerAuth: []
components:
  schemas:
    Pagination:
      type: object
      properties:
        limit:
          type: integer
        offset:
          type: integer
        total:
          type: integer
      required:
        - limit
        - offset
        - total
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.