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

# List models

> List available models grouped by provider. Each provider entry includes its code, name, an EU-hosted flag, and a list of models with id, name, description, recommendation metadata, pricing, latency/intelligence ratings, latency ranges, and supported configuration ranges (temperature, max_tokens).



## OpenAPI

````yaml https://api.itellico.ai/v1/openapi.json get /v1/accounts/{account_id}/providers/models
openapi: 3.1.0
info:
  title: itellicoAI API v1
  version: 1.0.0
  description: >-
    Public REST API for managing accounts, agents, telephony resources, and
    conversations.


    Authentication is via API key in the `X-API-Key` header.
  termsOfService: https://itellico.ai/legal/terms-and-conditions/
  contact:
    name: itellicoAI Support
    email: support@itellico.ai
  license:
    name: Proprietary
servers:
  - url: https://api.itellico.ai
    description: Production
security:
  - APIKeyAuth: []
tags:
  - name: Accounts
    description: >-
      Identify the current account context and fetch core account metadata to
      bootstrap API usage.
  - name: Subaccounts
    description: >-
      Create and manage child accounts under a parent to model tenant
      hierarchies and delegated access.
  - name: Agents
    description: >-
      Define and configure conversational agents (model, transcriber, voice,
      behavior) used in calls and automations.
  - name: Providers
    description: >-
      Discover available AI model, transcriber, and voice catalogs for the
      current account when configuring agents.
  - name: Phone Numbers
    description: >-
      Manage BYOC phone numbers bound to your account; route inbound calls to
      agents and enable outbound calling.
  - name: SIP Trunks
    description: >-
      Manage BYOC SIP trunk connectivity (origination/termination endpoints and
      allowed IPs) used by phone numbers.
  - name: Calls
    description: >-
      Create, list, inspect, and connect voice calls across phone and web
      channels.
  - name: Conversations
    description: List and inspect conversation activity across web and telephony channels.
  - name: Analytics
    description: Usage analytics and reporting endpoints for conversation activity.
paths:
  /v1/accounts/{account_id}/providers/models:
    get:
      tags:
        - Providers
      summary: List models
      description: >-
        List available models grouped by provider. Each provider entry includes
        its code, name, an EU-hosted flag, and a list of models with id, name,
        description, recommendation metadata, pricing, latency/intelligence
        ratings, latency ranges, and supported configuration ranges
        (temperature, max_tokens).
      operationId: listModels
      parameters:
        - in: path
          name: account_id
          schema:
            title: Account Id
            type: string
          required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                items:
                  $ref: '#/components/schemas/ModelCatalogEntrySchema'
                title: Response
                type: array
      security:
        - APIKeyAuth: []
components:
  schemas:
    ModelCatalogEntrySchema:
      description: Provider with its list of models.
      properties:
        provider:
          $ref: '#/components/schemas/ModelCatalogProviderSchema'
        models:
          items:
            $ref: '#/components/schemas/ModelCatalogModelSchema'
          title: Models
          type: array
      required:
        - provider
        - models
      title: ModelCatalogEntrySchema
      type: object
    ModelCatalogProviderSchema:
      description: Provider metadata for a group of models.
      properties:
        code:
          description: Provider code (e.g., azure_openai, openai)
          title: Code
          type: string
        name:
          description: Human-friendly provider name
          title: Name
          type: string
        eu_hosted:
          default: false
          description: Whether the provider is EU-hosted (data residency)
          title: Eu Hosted
          type: boolean
      required:
        - code
        - name
      title: ModelCatalogProviderSchema
      type: object
    ModelCatalogModelSchema:
      description: Single model entry in the catalog.
      properties:
        id:
          description: Canonical model id without provider prefix
          title: Id
          type: string
        name:
          description: Display name for the model
          title: Name
          type: string
        description:
          anyOf:
            - type: string
            - type: 'null'
          default: ''
          description: Short description or guidance for the model
          title: Description
        recommended:
          anyOf:
            - type: boolean
            - type: 'null'
          description: Whether this model is recommended for most use cases
          title: Recommended
        pricing:
          anyOf:
            - $ref: '#/components/schemas/ModelPricingSchema'
            - type: 'null'
          description: Optional pricing metadata for the model
        settings:
          anyOf:
            - $ref: '#/components/schemas/ModelSettingsRangeSchema'
            - type: 'null'
          description: Supported configuration ranges for this model
        latency_rating:
          anyOf:
            - type: number
            - type: 'null'
          description: Relative latency rating on a 1-5 scale
          title: Latency Rating
        intelligence_rating:
          anyOf:
            - type: number
            - type: 'null'
          description: Relative intelligence rating on a 1-5 scale
          title: Intelligence Rating
        latency_range:
          anyOf:
            - $ref: '#/components/schemas/ModelLatencyRangeSchema'
            - type: 'null'
          description: Observed latency range in milliseconds
      required:
        - id
        - name
      title: ModelCatalogModelSchema
      type: object
    ModelPricingSchema:
      description: Optional pricing metadata for a model.
      properties:
        additional_cost_per_minute:
          anyOf:
            - type: number
            - type: 'null'
          description: Extra cost per minute for this model tier
          title: Additional Cost Per Minute
        tier:
          anyOf:
            - type: string
            - type: 'null'
          description: Pricing tier label
          title: Tier
      title: ModelPricingSchema
      type: object
    ModelSettingsRangeSchema:
      description: Supported configurable ranges for a model (temperature, max_tokens).
      properties:
        temperature:
          anyOf:
            - $ref: '#/components/schemas/ModelRangeSchema'
            - type: 'null'
          description: Allowed temperature range and default
        max_tokens:
          anyOf:
            - $ref: '#/components/schemas/ModelRangeSchema'
            - type: 'null'
          description: Allowed max_tokens range and default
      title: ModelSettingsRangeSchema
      type: object
    ModelLatencyRangeSchema:
      description: Observed latency range for a model in milliseconds.
      properties:
        min_ms:
          anyOf:
            - type: integer
            - type: number
            - type: 'null'
          description: Lower bound of observed latency in milliseconds
          title: Min Ms
        max_ms:
          anyOf:
            - type: integer
            - type: number
            - type: 'null'
          description: Upper bound of observed latency in milliseconds
          title: Max Ms
      title: ModelLatencyRangeSchema
      type: object
    ModelRangeSchema:
      description: Numeric range with optional default/min/max.
      properties:
        default:
          anyOf:
            - type: number
            - type: 'null'
          description: Default value used when not specified
          title: Default
        min:
          anyOf:
            - type: number
            - type: 'null'
          description: Minimum allowed value
          title: Min
        max:
          anyOf:
            - type: number
            - type: 'null'
          description: Maximum allowed value
          title: Max
      title: ModelRangeSchema
      type: object
  securitySchemes:
    APIKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key

````