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

# Canonical models

> Query the model directory for a live list of all available canonical model IDs.

A *canonical model ID* (a stable, provider-agnostic string like `gpt-4o-2024-08-06` or `claude-sonnet-4-6`) is the model identifier you pass in API requests. You can also pass an *alias* — a shorter name that resolves to a canonical ID, such as `claude-opus-4-5` (which resolves to `claude-opus-4-5-20251101`); each model's aliases are listed in its directory entry. Auriko maintains a live model directory. It's the authoritative source for all available models, their status, providers, and pricing.

## Query model directory

`GET /v1/directory/models` returns every canonical model with full metadata: context window, pricing, capabilities, supported modalities, supported endpoints, and provider availability. The endpoint is public and doesn't require authentication.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.auriko.ai/v1/directory/models
  ```

  ```python Python Auriko theme={null}
  import os
  from auriko import Client

  client = Client(
      api_key=os.environ["AURIKO_API_KEY"],
      base_url="https://api.auriko.ai/v1"
  )

  directory = client.models.list_directory()
  for canonical_id, model in directory.models.items():
      print(canonical_id, model.display_name, len(model.providers), "providers")
  ```

  ```typescript TypeScript Auriko theme={null}
  import { Client } from "@auriko/sdk";

  const client = new Client({
      apiKey: process.env.AURIKO_API_KEY,
      baseUrl: "https://api.auriko.ai/v1",
  });

  const directory = await client.models.listDirectory();
  for (const [canonicalId, model] of Object.entries(directory.models)) {
      console.log(canonicalId, model.display_name, model.providers.length, "providers");
  }
  ```
</CodeGroup>

See the [Model directory](/api-reference/model-directory) reference for the full response schema.

## Query model catalog

`GET /v1/registry/models` returns a leaner list of canonical ID, author, status, and provider availability, without pricing details.

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.auriko.ai/v1/registry/models
  ```

  ```python Python Auriko theme={null}
  import os
  from auriko import Client

  client = Client(
      api_key=os.environ["AURIKO_API_KEY"],
      base_url="https://api.auriko.ai/v1"
  )

  catalog = client.models.list_registry()
  for model in catalog.models:
      print(model.id, model.providers)
  ```

  ```typescript TypeScript Auriko theme={null}
  import { Client } from "@auriko/sdk";

  const client = new Client({
      apiKey: process.env.AURIKO_API_KEY,
      baseUrl: "https://api.auriko.ai/v1",
  });

  const catalog = await client.models.listRegistry();
  for (const model of catalog.models) {
      console.log(model.id, model.providers);
  }
  ```
</CodeGroup>

See the [Canonical model records](/api-reference/canonical-model-records) reference for the full response schema.