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

# Get the models a provider offers

> Get the models to offer for a provider, with the catalog already merged against the organization's saved models.
Serves both the create and edit flows: when the organization has not configured this provider, every row comes back with a null `uuid`. A row's `uuid` is what marks it as saved by this organization; the response carries no notion of what is currently checked in the client's form.




## OpenAPI

````yaml GET /v3/llm-gateway/providers/{provider}/available-models
openapi: 3.0.3
info:
  title: Fiddler API - 2.0
  description: APIs to interact with Fiddler
  termsOfService: https://fiddler.ai/about/terms
  contact:
    email: support@fiddler.ai
  license:
    name: Proprietary
    url: '2.0'
  version: '2.0'
servers: []
security:
  - BearerAuth: []
tags:
  - name: access-key
    description: CRUD operations for API keys
  - name: span-v3
  - name: aggregation-invalidation-request-v3
    description: Endpoints related to retrieving aggregation invalidation requests
  - name: alert-rules-v3
    description: CRUD for Alert Rules, Summary, and Stats APIs
  - name: application-v3
  - name: auth
    description: Authentication strategies and login flows
  - name: baseline-v3
    description: CRUD for baseline
  - name: catalog-v3
    description: >-
      Entity catalog provides paginated, searchable discovery of entity names
      (attribute keys, agent names, span types, span names, score names,
      evaluator config names) and their distinct values. Powered by ClickHouse
      materialized views — no worker or PostgreSQL dependency.
  - name: chart-annotation-v3
    description: Endpoints related to retrieving chart annotations
  - name: chart-v3
    description: CRUD for chart
  - name: queries-v3
    description: v3 queries API
  - name: configuration-v3
    description: CRUD for configurations
  - name: custom-metrics-v3
  - name: dimensionality-reduction-v3
  - name: environment-v3
    description: Endpoints related to environment management
  - name: evals
  - name: datasets
  - name: evaluation-v3
  - name: evaluator-v3
  - name: rule-evaluators-v3
  - name: experiment-v3
  - name: explainability-v3
  - name: llm_rca-v3
  - name: file-upload
    description: Endpoints related to file uploading.
  - name: fql-expressions-v3
    description: >
      Endpoints for listing FQL (Fiddler Query Language) functions available for
      GenAI custom metrics. Used by the frontend for autocomplete and signature
      hints in the FQL editor.
  - name: genai-alert-rules-v3
    description: CRUD API for GenAI Alert Rules
  - name: genai-custom-metrics-v3
    description: API for GenAI Custom Metrics
  - name: genai-metrics-v3
    description: >-
      Endpoints for pre-aggregated GenAI metrics. All metric data is
      pre-aggregated hourly by a Celery-based metric collector; no real-time
      aggregation is performed at request time.
  - name: guardrails-api
    description: Endpoints related to retrieving Guardrails specific data
  - name: ingestion-v3
  - name: intercom-api
    description: Endpoints related to intercom APIs
  - name: jobs-v3
  - name: llm-gateway-v3
  - name: auth-login
  - name: auth-logout
  - name: mcp-client-setup-v3
    description: Endpoints for retrieving MCP client setup instructions.
  - name: metrics-v3
    description: Metrics endpoints
  - name: model-v3
  - name: dashboard-v3
  - name: model-deployment-v3
  - name: monitoring-summary-v3
  - name: histograms-v3
  - name: organization-roles-v3
    description: Update user org role
  - name: organization-settings-v3
    description: Update organization settings such as timezone, email configuration, etc.
  - name: pagerduty-api
    description: CRUD for Pagerduty services.
  - name: project-v3
  - name: project-roles-v3
    description: Project role assignment management
  - name: scores-v3
    description: Unified CRUD for scores and annotations
  - name: searchable-text-key-v3
    description: >-
      Manage the global searchable text keys table that controls which OTel
      attribute keys are routed to the full-text-searchable `ValueContent`
      column in the unified attributes table. Changes propagate to the backing
      ClickHouse dictionary within 1-2 minutes and affect all tenants.
  - name: segments-v3
  - name: semantic-mapping-v3
    description: >-
      Manage the global semantic name mappings table that maps raw OTel
      attribute keys to canonical semantic concepts. Changes propagate to the
      backing ClickHouse dictionary within 1-2 minutes and affect all tenants.
  - name: server-info-v3
    description: Endpoints related to retrieving server information
  - name: sessions-v3
    description: v3 session APIs
  - name: team-roles-v3
  - name: team-v3
  - name: traces-v3
    description: v3 trace api for monitoring
  - name: fetch-sessions-v3
    description: v3 fetch sessions api for monitoring
  - name: user-access-key
    description: >
      CRUD operations for user API keys. All endpoints are user-scoped — each
      user can only operate on their own API keys. No one including Org admins
      have access to other users' API keys.
  - name: users-v3
  - name: version-compatibility-v3
  - name: webhooks
externalDocs:
  url: https://docs.fiddler.ai
  description: Find out more about Fiddler
paths:
  /v3/llm-gateway/providers/{provider}/available-models:
    get:
      tags:
        - llm-gateway-v3
      summary: Get the models a provider offers
      description: >
        Get the models to offer for a provider, with the catalog already merged
        against the organization's saved models.

        Serves both the create and edit flows: when the organization has not
        configured this provider, every row comes back with a null `uuid`. A
        row's `uuid` is what marks it as saved by this organization; the
        response carries no notion of what is currently checked in the client's
        form.
      operationId: getLLMProviderAvailableModelsV3
      parameters:
        - $ref: '#/components/parameters/provider'
      responses:
        '200':
          description: The models this provider offers
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/ApiResponse'
                  - type: object
                    properties:
                      data:
                        $ref: '#/components/schemas/ProviderAvailableModels'
              examples:
                success:
                  summary: >-
                    An unsaved active model, plus two saved ones now deprecating
                    and retired
                  value:
                    api: v3
                    data:
                      provider: openai
                      allows_custom_models: true
                      models:
                        - name: gpt-5.5
                          state: active
                          user_defined: false
                        - name: gpt-5-2025-08-07
                          uuid: 550e8400-e29b-41d4-a716-446655440000
                          state: deprecating
                          retire_at: '2026-12-11'
                          user_defined: false
                        - name: gpt-4-vision-preview
                          uuid: 550e8400-e29b-41d4-a716-446655440011
                          state: retired
                          retire_at: '2025-12-06'
                          user_defined: false
        '404':
          $ref: '#/components/responses/404'
        '500':
          $ref: '#/components/responses/500'
components:
  parameters:
    provider:
      name: provider
      in: path
      description: Name of the LLM provider (e.g., OpenAI, Anthropic)
      required: true
      schema:
        type: string
  schemas:
    ApiResponse:
      type: object
      description: |
        Response object for standard API responses.
      properties:
        api_version:
          type: string
          default: '3.0'
          enum:
            - '2.0'
            - '3.0'
          description: |
            API version.
        kind:
          type: string
          default: NORMAL
          enum:
            - NORMAL
          description: |
            Type of response, indicating a normal response.
    ProviderAvailableModels:
      type: object
      title: Provider Model Picker
      description: >
        The provider model picker's rows, with the catalog already merged
        against the organization's saved models.

        Clients render this list verbatim; no join against the catalog is
        required.

        A retired model is included only when the organization has it saved,
        since unchecking it is the only remaining action.
      required:
        - provider
        - allows_custom_models
        - models
      properties:
        provider:
          type: string
          description: The provider identifier
        allows_custom_models:
          description: Whether users may enter model names beyond the catalog
          type: boolean
        models:
          type: array
          items:
            $ref: '#/components/schemas/AvailableModel'
          description: >
            Rows to render, in catalog order with write-ins appended.

            Every model the organization has saved is always present, whatever
            its state.

            Updating a provider replaces its whole model list, so a saved model
            omitted here would be deleted on the next save.
    AvailableModel:
      type: object
      title: Available Model
      description: One row of the provider model picker.
      required:
        - name
        - state
        - user_defined
      properties:
        name:
          description: Model name
          type: string
          maxLength: 128
        uuid:
          description: >-
            UUID of the saved model row, or null when the organization has not
            saved this model. A non-null value is what marks the model as saved;
            there is no separate flag.
          type: string
          format: uuid
          nullable: true
        state:
          description: >-
            Lifecycle state. A saved model absent from the catalog reads as
            'retired' with no date, unless the provider allows custom models.
          type: string
          enum:
            - active
            - deprecating
            - retired
        retire_at:
          description: ISO date the provider stops serving the model
          type: string
          format: date
          nullable: true
        user_defined:
          description: Entered by a user rather than drawn from the catalog
          type: boolean
    ErrorResponse:
      type: object
      description: |
        Response object for errors returned by the API.
      properties:
        api_version:
          type: string
          default: '3.0'
          enum:
            - '2.0'
            - '3.0'
          description: |
            API version of the response.
        kind:
          type: string
          default: ERROR
          enum:
            - ERROR
          description: |
            Type of response, usually indicating an error.
        error:
          type: object
          properties:
            code:
              type: integer
              format: int32
              description: >
                Represents the code for this error, typically an HTTP response
                code.
              default: 400
              enum:
                - 400
                - 403
                - 404
                - 500
            message:
              type: string
              description: >
                A human-readable message providing more details about the error.
                If there are multiple errors, it will be the message for the
                first error.
              example: Resource Not Found
            errors:
              type: array
              description: >
                Container for additional information regarding the error,
                especially for multiple errors.
              items:
                type: object
                properties:
                  reason:
                    type: string
                    description: >
                      Unique identifier for this error, different from the error
                      code.
                    example: ResourceNotFoundException
                  message:
                    type: string
                    description: >
                      A human-readable message providing more details about the
                      error. If there is only one error, this field will match
                      error.message.
                    example: Resource Not Found
                  help:
                    type: string
                    description: >
                      Link to support or documentation providing more
                      information on the error.
  responses:
    '404':
      description: Resource not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    '500':
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer

````