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

# List Providers

> Returns all AI providers associated with the current license.

**Response Fields:**
- `id`: Provider ID (use for querying models/voices and creating avatars)
- `provider`: Provider type (openai, elevenlabs, cartesia)
- `name`: Display name
- `scopeType`: Provider ownership scope
  - `SYSTEM`: Platform-wide providers (managed by admin)
  - `USER`: User-created custom providers (only visible to the owner)

**Use Case:**
Use the returned `id` when:
- Creating avatars
- Querying models/voices
- Creating custom models/voices (USER scope providers only)



## OpenAPI

````yaml GET /api/open/v1/provider/list
openapi: 3.1.0
info:
  title: NavTalk API
  description: NavTalk API for AI avatar management, file uploads, and video generation
  version: 1.0.0
servers:
  - url: https://api.navtalk.ai
    description: NavTalk Production Environment Server
  - url: https://qaapi.navtalk.ai
    description: NavTalk QA Environment Server
  - url: https://devapi.navtalk.ai
    description: NavTalk Development Environment Server
security:
  - navtalkLicenseAuth: []
paths:
  /api/open/v1/provider/list:
    get:
      tags:
        - Provider
      summary: List Providers
      description: >-
        Returns all AI providers associated with the current license.


        **Response Fields:**

        - `id`: Provider ID (use for querying models/voices and creating
        avatars)

        - `provider`: Provider type (openai, elevenlabs, cartesia)

        - `name`: Display name

        - `scopeType`: Provider ownership scope
          - `SYSTEM`: Platform-wide providers (managed by admin)
          - `USER`: User-created custom providers (only visible to the owner)

        **Use Case:**

        Use the returned `id` when:

        - Creating avatars

        - Querying models/voices

        - Creating custom models/voices (USER scope providers only)
      operationId: listProviders
      parameters: []
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProviderListResponse'
              example:
                code: 200
                message: SUCCESS
                data:
                  - id: b92a28fb2ea737457c7f13ba554759c0
                    provider: elevenlabs
                    name: My ElevenLabs Provider
                    scopeType: USER
                  - id: system_provider_001
                    provider: openai
                    name: OpenAI GPT-4o
                    scopeType: SYSTEM
                  - id: system_provider_002
                    provider: cartesia
                    name: Cartesia
                    scopeType: SYSTEM
        '400':
          description: License validation failed or server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NavtalkErrorResponse'
              example:
                code: 400
                message: Invalid license key
      security:
        - navtalkLicenseAuth: []
components:
  schemas:
    ProviderListResponse:
      type: object
      properties:
        code:
          type: integer
          example: 200
        message:
          type: string
          example: SUCCESS
        data:
          type: array
          items:
            $ref: '#/components/schemas/OpenProvider'
    NavtalkErrorResponse:
      type: object
      properties:
        code:
          type: integer
          example: 400
        message:
          type: string
          example: Invalid license key
    OpenProvider:
      type: object
      properties:
        id:
          type: string
          description: Unique provider ID.
          example: b92a28fb2ea737457c7f13ba554759c0
        provider:
          type: string
          enum:
            - openai
            - elevenlabs
            - cartesia
          description: Provider type identifier.
          example: elevenlabs
        name:
          type: string
          description: Display name of the provider.
          example: My ElevenLabs Provider
        scopeType:
          type: string
          description: >-
            Provider ownership scope. 'SYSTEM' for platform-wide providers,
            'USER' for user-created providers.
          enum:
            - SYSTEM
            - USER
          example: USER
  securitySchemes:
    navtalkLicenseAuth:
      type: apiKey
      in: header
      name: license
      description: NavTalk API license key (e.g. sk_navtalk_...)

````