---
title: "Get model details"
method: GET
path: "/api/v1/models/{modelId}"
tags: ["Models"]
---

# Get model details

`GET /api/v1/models/{modelId}`

## Request

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

Retrieve full details for a single model, including version history, asset usage count, and preview count.

## Path parameters

- `modelId` string, required: Model SHA-1 hash identifier (40-character hex string)

## Response `200`

Model details

- object
  - `data` ModelDetail, required: Full model record including version history
    - `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
    - `description` string, nullable: Freeform model description
    - `is_active` boolean, required
    - `versions` ModelVersion[], required
      - `version_tag` string, required: Version identifier
      - `version_notes` string, nullable
      - `training_steps` integer, nullable
      - `quality_score` number, nullable
      - `is_recommended` boolean, required
      - `trained_at` string, date-time, nullable
      - `load_date` string, date-time, required
    - `preview_count` integer, required: Number of preview images available

## Other responses

- `400`: Invalid modelId format
- `401`: Unauthorized
- `404`: Model not found or tenant mismatch

---

[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)