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

# List models

> Lists the models your key may use, narrowed to the models your organization approved.



## OpenAPI

````yaml /api-reference/openapi.json get /anthropic/v1/models
openapi: 3.1.0
info:
  title: Altrum AI Gateway API
  version: 1.0.0
  description: >-
    The public API of the Altrum AI Gateway. It accepts the OpenAI, Anthropic
    and Gemini request formats, so an existing client needs only a new base URL
    and a virtual key.
servers:
  - url: https://api.altrum.ai
security:
  - bearer: []
  - apiKey: []
  - googleApiKey: []
  - altrumKey: []
tags:
  - name: OpenAI
  - name: Anthropic
  - name: Gemini
  - name: MCP
  - name: Health
paths:
  /anthropic/v1/models:
    get:
      tags:
        - Anthropic
      summary: List models
      description: >-
        Lists the models your key may use, narrowed to the models your
        organization approved.
      operationId: listAnthropicModels
      parameters:
        - $ref: '#/components/parameters/RequestIdIn'
      responses:
        '200':
          description: The models.
          headers:
            x-request-id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    example: list
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                      additionalProperties: true
                additionalProperties: true
                example:
                  object: list
                  data:
                    - id: openai/gpt-4o-mini
                      object: model
              example:
                object: list
                data:
                  - id: openai/gpt-4o-mini
                    object: model
        '401':
          description: No virtual key was sent, or the key does not exist or was revoked.
          headers:
            x-request-id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnthropicError'
        '403':
          description: >-
            The key, AI system, organization, model, provider or tool is not
            allowed.
          headers:
            x-request-id:
              $ref: '#/components/headers/RequestId'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AnthropicError'
components:
  parameters:
    RequestIdIn:
      name: x-request-id
      in: header
      required: false
      description: >-
        Your own reference for the request. Altrum uses it instead of making
        one, and returns it.
      schema:
        type: string
  headers:
    RequestId:
      description: The request's reference. Quote it to support.
      schema:
        type: string
  schemas:
    AnthropicError:
      type: object
      description: An error on the Anthropic routes.
      properties:
        type:
          type: string
          const: error
        error:
          type: object
          properties:
            type:
              type: string
              description: A refusal code or a stable code.
            message:
              type: string
        request_id:
          type: string
      example:
        type: error
        error:
          type: model_blocked
          message: Model 'claude-opus-4' is not allowed
        request_id: 4f9c...
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      description: >-
        Your virtual key, `sk-alt-...`. What every OpenAI and Anthropic SDK
        sends.
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
      description: Your virtual key, as Anthropic clients send it.
    googleApiKey:
      type: apiKey
      in: header
      name: x-goog-api-key
      description: Your virtual key, as Gemini clients send it.
    altrumKey:
      type: apiKey
      in: header
      name: x-alt-vk
      description: >-
        Your virtual key. Needed when `Authorization` carries your own provider
        key (`x-alt-direct-key`).

````

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