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

# List models

> This endpoint mimics the OpenAI models endpoint format, returning a list of
available models with their associated metadata. Each model includes standard
OpenAI-compatible fields to ensure compatibility with existing OpenAI client libraries.



## OpenAPI

````yaml cloud-api-reference/openapi.yml get /v1/models
openapi: 3.1.0
info:
  title: atoma-proxy
  description: ''
  license:
    name: Apache-2.0
    identifier: Apache-2.0
  version: 0.1.0
servers:
  - url: https://api.atoma.network
security: []
tags:
  - name: Completions
    description: OpenAI's API completions v1 endpoint
  - name: Confidential Completions
    description: Atoma's API confidential completions v1 endpoint
  - name: Chat
    description: OpenAI's API chat completions v1 endpoint
  - name: Confidential Chat
    description: Atoma's API confidential chat completions v1 endpoint
  - name: Confidential Embeddings
    description: Atoma's API confidential embeddings v1 endpoint
  - name: Confidential Images
    description: Atoma's API confidential images v1 endpoint
  - name: Embeddings
    description: OpenAI's API embeddings v1 endpoint
  - name: Health
    description: Health check
  - name: Images
    description: OpenAI's API images v1 endpoint
  - name: Models
    description: OpenAI's API models v1 endpoint
  - name: Nodes
    description: Nodes Management
  - name: Node Public Key Selection
    description: Node public key selection
paths:
  /v1/models:
    get:
      tags:
        - Models
      summary: List models
      description: >-
        This endpoint mimics the OpenAI models endpoint format, returning a list
        of

        available models with their associated metadata. Each model includes
        standard

        OpenAI-compatible fields to ensure compatibility with existing OpenAI
        client libraries.
      operationId: models_list
      responses:
        '200':
          description: List of available models
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelList'
        '500':
          description: Failed to retrieve list of available models
      security:
        - bearerAuth: []
      x-codeSamples:
        - lang: typescript
          label: models_list
          source: |-
            import { AtomaSDK } from "atoma-sdk";

            const atomaSDK = new AtomaSDK({
              bearerAuth: process.env["ATOMASDK_BEARER_AUTH"] ?? "",
            });

            async function run() {
              const result = await atomaSDK.models.modelsList();

              // Handle the result
              console.log(result);
            }

            run();
        - lang: python
          label: models_list
          source: |-
            from atoma_sdk import AtomaSDK
            import os

            with AtomaSDK(
                bearer_auth=os.getenv("ATOMASDK_BEARER_AUTH", ""),
            ) as atoma_sdk:

                res = atoma_sdk.models.models_list()

                # Handle response
                print(res)
components:
  schemas:
    ModelList:
      type: object
      description: Response object for the models listing endpoint
      required:
        - object
        - data
      properties:
        data:
          type: array
          items:
            $ref: '#/components/schemas/Model'
          description: List of model objects
        object:
          type: string
          description: The object type, which is always "list"
    Model:
      type: object
      description: Individual model object in the response
      required:
        - id
        - object
        - created
        - owned_by
      properties:
        created:
          type: integer
          format: int64
          description: Unix timestamp (in seconds) when this model was created
        id:
          type: string
          description: The model identifier
        object:
          type: string
          description: The object type, which is always "model"
        owned_by:
          type: string
          description: Organization that owns the model
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````