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

# Get model details

`GET /v1/models/{model_id}`

Get detailed information about an org-level model.

## Path parameters

- `model_id` string, required

## Response `200`

Successful Response

- OrgModelDetailResponse — Response model for org model details.
  - `success` boolean
  - `model` OrgModelDocument, required — Org-level model document stored in MongoDB. Org-scoped: Uses organization_id instead of namespace_id. Models belong to an organization and can be enabled in any namespace within that org.
    - `model_id` string, required — Unique model identifier
    - `organization_id` string, required — Owner organization ID
    - `name` string, required — Model name
    - `version` string, required — Model version (semver)
    - `description` string, nullable — Model description
    - `source` 'customer' | 'mixpeek' | 'system' — Who created this model: 'customer' (org-uploaded), 'mixpeek' (professional services), or 'system' (globally available)
    - `exportable` boolean — Whether the model archive can be downloaded by the customer. Auto-set to False for source='mixpeek'.
    - `s3_archive_url` string, required — S3 URL to model archive
    - `model_format` 'safetensors' | 'onnx' | 'pytorch' | 'huggingface', required — Model format/framework
    - `model_hash` string, required — SHA256 hash of model archive
    - `validation_status` 'passed' | 'failed' | 'pending', required — Validation status
    - `validation_errors` string[] — Validation error messages
    - `deployed` boolean — Whether model has been deployed to any namespace
    - `deployment_info` OrgModelDeploymentInfo — Deployment information for an org-level model.
      - `ray_cluster_url` string, nullable — Ray cluster URL where model is deployed
      - `ray_deployment_name` string, nullable — Ray deployment name
      - `deployed_at` string, date-time, nullable — When the model was deployed
    - `framework` string, nullable — ML framework (e.g., sentence-transformers)
    - `task_type` string, nullable — Task type (e.g., embedding, classification)
    - `input_schema` object, nullable — Input schema JSON
    - `output_schema` object, nullable — Output schema JSON
    - `resource_requirements` ModelResourceRequirements — Resource requirements for model deployment.
      - `num_cpus` number — Number of CPUs
      - `num_gpus` integer — Number of GPUs
      - `memory` integer — Memory in bytes (default 4GB)
    - `created_at` string, date-time — Creation timestamp
    - `updated_at` string, date-time — Last update timestamp

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Validation Error
- `500` — Internal Server Error

---

[API](https://skmtc.net/mixpeek/apis/mixpeek-api.md) · [All operations](https://skmtc.net/mixpeek/apis/mixpeek-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mixpeek/mixpeek-api/versions/04b379bdbb7c/schema)