---
title: "List Models"
method: GET
path: "/api/v1/models"
tags: ["models"]
---

# List Models

`GET /api/v1/models`

OpenAI-style model listing.
Returns: {"object":"list","data":[{...model objects...}]}

Models are filtered based on:
- enabled: must be True
- listed: must be True (unless an admin/manager passes `include_hidden=true`)
- provider: must be openrouter or prime
- custom models: unauthenticated callers only see base model routes
- enabled_tenants: empty array = public, otherwise user/team must be in list
  (admin/manager can bypass only with `include_hidden=true`)
- lora_status: LoRAs must be "ready" (base models always pass)

## Query parameters

- `include_hidden` boolean — Include hidden and tenant-scoped models outside the caller's normal scope. Honored only for ADMIN/MANAGER; ignored otherwise.

## Headers

- `authorization` string, nullable
- `x-api-key` string, nullable
- `X-Prime-Team-Id` string, nullable

## Response `200`

Successful Response

- OpenAIModelObjectList — OpenAI-compatible model list response schema.
  - `object` string
  - `data` OpenAIModelObject[], required
    - `id` string, required
    - `object` string
    - `owned_by` string, nullable
    - `created` integer, nullable
    - `pricing` PricingInfo
      - `input_usd_per_mtok` number, nullable
      - `output_usd_per_mtok` number, nullable
      - `effective_at` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/pinference/apis/pi-inference.md) · [All operations](https://skmtc.dev/pinference/apis/pi-inference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pinference/pi-inference/revisions/707211c46ce9/schema)