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

# List models

`GET /api/v1/models`

## Request

- Base URL: `https://numonic.ai`
- URL: `https://numonic.ai/api/v1/models`
- Auth: API key in header `x-api-key`

Search and list AI models in the Model Library with optional filters for model type, base model, and free-text search. Results include asset usage counts.

## Query parameters

- `type` string: Filter by model type (e.g., `lora`, `checkpoint`, `unet`)
- `base_model` string: Filter by base model (e.g., `flux`, `sdxl`)
- `q` string: Free-text search across name, display_name, and description
- `limit` integer: Maximum results to return
- `offset` integer: Number of results to skip

## Response `200`

Model list with pagination

- object
  - `data` ModelSummary[], required
    - `model` string, required: SHA-1 hash identifying this model
    - `model_id` string, uuid, nullable: Optional UUID identifier
    - `name` string, required: Canonical model name
    - `display_name` string, nullable: Human-friendly display name
    - `model_type` string, nullable: Model type (lora, checkpoint, unet, etc.)
    - `base_model` string, nullable: Base model family (flux, sdxl, etc.)
    - `recommended_weight` number, nullable: Recommended weight/strength
    - `trigger_words` string[], nullable: Trigger words for prompt activation
    - `external_url` string, uri, nullable: Source page URL
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `asset_usage_count` integer, required: Number of assets generated with this model
  - `pagination` object, required
    - `limit` integer, required
    - `offset` integer, required

## Other responses

- `400`: Invalid query parameters
- `401`: Unauthorized

---

[API](https://skmtc.dev/numonic/apis/numonic-api.md) · [All operations](https://skmtc.dev/numonic/apis/numonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/numonic/apis/numonic-api/revisions/6c559bef1e35?raw)