---
title: "Find the model bound to a partner external id"
method: GET
path: "/v1/partner-production/models"
tags: ["Partner production"]
---

# Find the model bound to a partner external id

`GET /v1/partner-production/models`

## Request

- Base URL: `https://api.printhiv3d.com`
- URL: `https://api.printhiv3d.com/v1/partner-production/models`
- Auth: API key in header `x-api-key`

## Query parameters

- `externalId` string

## Response `200`

Default Response

- object
  - `modelId` string, uuid, required
  - `externalId` string, required
  - `latestSource` union, required
    - object
      - `sourceVersionId` string, uuid, required
      - `modelId` string, uuid, required
      - `externalId` string, nullable, required
      - `sha256` string, required
      - `filename` string, required
      - `bytes` integer, required
      - `createdAt` string, date-time, required
      - `status` 'queued', required
    - object
      - `sourceVersionId` string, uuid, required
      - `modelId` string, uuid, required
      - `externalId` string, nullable, required
      - `sha256` string, required
      - `filename` string, required
      - `bytes` integer, required
      - `createdAt` string, date-time, required
      - `status` 'inspecting', required
    - object
      - `sourceVersionId` string, uuid, required
      - `modelId` string, uuid, required
      - `externalId` string, nullable, required
      - `sha256` string, required
      - `filename` string, required
      - `bytes` integer, required
      - `createdAt` string, date-time, required
      - `status` 'ready', required
      - `inspection` object, required
        - `version` 1, required
        - `classification` 'project' | 'geometry_only' | 'toolpath_only', required
        - `hasEmbeddedGcode` boolean, required
        - `plates` object[], required
          - `number` integer, required
          - `objectIds` string[], required
        - `objects` object[], required
          - `id` string, required
          - `entry` string, required
          - `objectId` integer, required
          - `name` string, nullable, required
          - `kind` 'mesh' | 'assembly' | 'support' | 'other', required
          - `materialSlots` integer[], required
        - `materialSlots` object[], required
          - `slot` integer, required
          - `material` string, nullable, required
          - `color` string, nullable, required
          - `profile` string, nullable, required
        - `materialUsage` 'complete' | 'requires_review', required
        - `reviewReasons` string[], required
        - `authoringEngine` union
          - object
            - `status` 'recognized', required
            - `family` 'bambu_studio' | 'orca_slicer', required
            - `release` string, required
            - `releaseLine` string, required
            - `major` integer, required
            - `evidence` string[], required
          - object
            - `status` 'unsupported_family', required
            - `application` string, required
          - object
            - `status` 'fork', required
            - `application` string, required
            - `release` string, required
          - object
            - `status` 'disagreeing', required
            - `values` object, required
              - …
          - object
            - `status` 'unparseable', required
            - `values` object, required
              - …
          - object
            - `status` 'missing', required
        - `printerModel` string
    - object
      - `sourceVersionId` string, uuid, required
      - `modelId` string, uuid, required
      - `externalId` string, nullable, required
      - `sha256` string, required
      - `filename` string, required
      - `bytes` integer, required
      - `createdAt` string, date-time, required
      - `status` 'failed', required
      - `inspection` object, nullable, required
        - `version` 1, required
        - `classification` 'project' | 'geometry_only' | 'toolpath_only', required
        - `hasEmbeddedGcode` boolean, required
        - `plates` object[], required
          - `number` integer, required
          - `objectIds` string[], required
        - `objects` object[], required
          - `id` string, required
          - `entry` string, required
          - `objectId` integer, required
          - `name` string, nullable, required
          - `kind` 'mesh' | 'assembly' | 'support' | 'other', required
          - `materialSlots` integer[], required
        - `materialSlots` object[], required
          - `slot` integer, required
          - `material` string, nullable, required
          - `color` string, nullable, required
          - `profile` string, nullable, required
        - `materialUsage` 'complete' | 'requires_review', required
        - `reviewReasons` string[], required
        - `authoringEngine` union
          - object
            - `status` 'recognized', required
            - `family` 'bambu_studio' | 'orca_slicer', required
            - `release` string, required
            - `releaseLine` string, required
            - `major` integer, required
            - `evidence` string[], required
          - object
            - `status` 'unsupported_family', required
            - `application` string, required
          - object
            - `status` 'fork', required
            - `application` string, required
            - `release` string, required
          - object
            - `status` 'disagreeing', required
            - `values` object, required
              - …
          - object
            - `status` 'unparseable', required
            - `values` object, required
              - …
          - object
            - `status` 'missing', required
        - `printerModel` string
      - `error` object, required
        - `code` 'invalid_archive' | 'unsafe_path' | 'unsafe_xml' | 'resource_limit' | 'invalid_project' | 'toolpath_only' | 'processing_timeout' | 'storage_object_changed' | 'inspection_interrupted' | 'upload_interrupted', required
        - `message` string, required
        - `limit` object
          - `name` 'uploadBytes' | 'concurrentUploads' | 'concurrentUploadsPerOrganization' | 'uploadIdleTimeoutMs' | 'uploadTimeoutMs' | 'entries' | 'compressionRatio' | 'modelPartExpandedBytes' | 'expandedBytes' | 'parserBytesPerDocument' | 'parserBytesPerArchive' | 'xmlDepth' | 'xmlElementsPerDocument' | 'objects' | 'plates' | 'materialSlots' | 'inspectionTimeoutMs' | 'inspectorHeapMb', required
          - `max` number, required
          - `observed` number

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: Default Response
- `503`: Default Response

## Changes

- **2026-10-31** `782c0bee2cd4`: 2 info
  - added `subschema #3, subschema #4` to the `latestSource` response property `anyOf` list for the response status `200`
  - removed `subschema #3, subschema #4` from the `latestSource` response property `anyOf` list for the response status `200`
- **2026-10-30** `f4d2cdd1c9f2`: 2 info
  - added `subschema #3, subschema #4` to the `latestSource` response property `anyOf` list for the response status `200`
  - removed `subschema #3, subschema #4` from the `latestSource` response property `anyOf` list for the response status `200`
- **2026-10-29** `4fa32c8d7c83`: 12 warning, 2 info
  - added the new `concurrentUploadsPerOrganization` enum value to the `limit/name` response property for the response status `400`
  - added the new `concurrentUploadsPerOrganization` enum value to the `limit/name` response property for the response status `404`
  - added the new `concurrentUploadsPerOrganization` enum value to the `limit/name` response property for the response status `503`
  - added the new `uploadIdleTimeoutMs` enum value to the `limit/name` response property for the response status `400`
  - …10 more
- **2026-10-29** `9012521db8f4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/partner-production/models/get.md)

---

[API](https://skmtc.dev/printhiv3d/apis/hive-api-documentation.md) - [All operations](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/revisions/906fa9f15f12?raw)