> ## Documentation Index > Fetch the complete documentation index at: https://docs.mixpeek.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # List organization models > List all custom models registered at the organization level. These models can be enabled in any namespace within the organization using the namespace-level enable endpoint. ## OpenAPI ````yaml get /v1/models openapi: 3.1.0 info: title: Mixpeek API description: >- This is the Mixpeek API, providing access to various endpoints for data processing and retrieval. termsOfService: https://mixpeek.com/terms contact: name: Mixpeek Support url: https://mixpeek.com/contact email: info@mixpeek.com version: '0.82' servers: - url: https://api.mixpeek.com description: Production security: - BearerAuth: [] paths: /v1/models: get: tags: - Models summary: List organization models description: |- List all custom models registered at the organization level. These models can be enabled in any namespace within the organization using the namespace-level enable endpoint. operationId: list_models_v1_models_get parameters: [] responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/OrgModelListResponse' '400': description: Bad Request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: Forbidden content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Unprocessable Entity content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '429': description: Too Many Requests content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '503': description: Service Unavailable content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - BearerAuth: [] components: schemas: OrgModelListResponse: properties: success: type: boolean title: Success default: true models: items: $ref: '#/components/schemas/OrgModelListItem' type: array title: Models total: type: integer title: Total organization_id: type: string title: Organization Id type: object required: - models - total - organization_id title: OrgModelListResponse description: Response model for listing org models. ErrorResponse: properties: success: type: boolean title: Success description: Always false for error responses default: false status: type: integer title: Status description: HTTP status code for this error error: $ref: '#/components/schemas/ErrorDetail' description: Error details payload type: object required: - status - error title: ErrorResponse description: Error response model. examples: - error: details: id: ns_123 resource: namespace message: Namespace not found type: NotFoundError status: 404 success: false OrgModelListItem: properties: model_id: type: string title: Model Id name: type: string title: Name version: type: string title: Version model_format: type: string enum: - safetensors - onnx - pytorch - huggingface title: Model Format description: anyOf: - type: string - type: 'null' title: Description source: type: string enum: - customer - mixpeek - system title: Source default: customer exportable: type: boolean title: Exportable default: true framework: anyOf: - type: string - type: 'null' title: Framework task_type: anyOf: - type: string - type: 'null' title: Task Type deployed: type: boolean title: Deployed validation_status: type: string title: Validation Status created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At registry: anyOf: - $ref: '#/components/schemas/ModelRegistryIdentity' - type: 'null' description: >- The ids this entry derives: registry id, shared model key, service id. tiering: anyOf: - $ref: '#/components/schemas/ModelTieringView' - type: 'null' description: The model's tier on the tiering ladder and its wake cost and time. type: object required: - model_id - name - version - model_format - deployed - validation_status - created_at - updated_at title: OrgModelListItem description: Model item in list response. ErrorDetail: properties: message: type: string title: Message description: Human-readable error message type: type: string title: Type description: Stable error type identifier (machine-readable) code: anyOf: - type: string - type: 'null' title: Code description: >- Fine-grained error code for programmatic handling (e.g., namespace_name_taken, feature_extractor_not_found). Present only when consumers may need to branch on a specific error condition. details: anyOf: - additionalProperties: true type: object - type: 'null' title: Details description: >- Optional structured details to help debugging (validation errors, IDs, etc.) type: object required: - message - type title: ErrorDetail description: Error detail model. ModelRegistryIdentity: properties: registry_id: type: string title: Registry Id description: 'Org-scoped registry key: org::.' shared_model_key: type: string title: Shared Model Key description: 'The key Serve deployments share the weights under: the model_id.' inference_service_id: type: string title: Inference Service Id description: The inference service and deployment name derived from registry_id. type: object required: - registry_id - shared_model_key - inference_service_id title: ModelRegistryIdentity description: >- The ids a model's registry entry derives from its ``model_id`` (plan 11.2). Computed on every read from the upload's id, so a model uploaded before these fields existed carries them too and nothing is stored twice. ModelTieringView: properties: tier: type: string enum: - warm - cold - frozen title: Tier description: 'The ladder rung the weights archive is on: warm, cold or frozen.' default: warm storage_tier: anyOf: - type: string - type: 'null' title: Storage Tier description: >- The storage tier the weights archive is held in: standard, nearline or coldline. It stays standard on a store without colder classes, where the tier is recorded and the archive is not moved. tier_changed_at: anyOf: - type: string format: date-time - type: 'null' title: Tier Changed At description: When the archive last moved to this tier. retrieval_usd_per_gb: anyOf: - type: number - type: 'null' title: Retrieval Usd Per Gb description: >- The storage class's retrieval fee per GiB read, charged when the model wakes from this tier. archive_bytes: anyOf: - type: integer - type: 'null' title: Archive Bytes description: The weights archive's size, recorded at registration. wake_retrieval_usd: anyOf: - type: number - type: 'null' title: Wake Retrieval Usd description: >- The retrieval fee for one wake from this tier: the fee per GiB times the archive size. Null when the size is not recorded. declared_wake_seconds: anyOf: - type: integer - type: 'null' title: Declared Wake Seconds description: >- The declared wake time for this tier: how long a call may take to start answering. exempt: anyOf: - type: string - type: 'null' title: Exempt description: Why this model never demotes, when it is exempt. type: object title: ModelTieringView description: >- Where a model's weights sit on the tiering ladder and what waking it costs (plan 7.10). securitySchemes: BearerAuth: type: http scheme: bearer description: >- Mixpeek API key, sent as `Authorization: Bearer mxp_sk_...`. Create one in Studio under Settings → API Keys, or with an admin key via `POST /v1/organizations/users/{user_email}/api-keys`. A missing, malformed, unknown, revoked, inactive or expired key returns 401; a key without the permission, scope or plan an operation needs returns 403. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.