---
title: "Poll a partner preparation request"
method: GET
path: "/v1/partner-production/preparations/{preparationId}"
tags: ["Partner production"]
---

# Poll a partner preparation request

`GET /v1/partner-production/preparations/{preparationId}`

## Request

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

## Path parameters

- `preparationId` string, uuid, required

## Response `200`

Default Response

- object
  - `preparationId` string, uuid, required
  - `status` 'waiting_for_source' | 'preparing' | 'held' | 'ready' | 'failed', required
  - `createdAt` string, date-time, required
  - `holds` object[], required
    - `item` integer, required
    - `plateNumber` integer, required
    - `hold` union, required
      - object
        - `code` 'inspection_review_required', required
        - `reason` string, required
      - object
        - `code` 'unmapped_used_slot', required
        - `slots` integer[], required
      - object
        - `code` 'project_source_too_large', required
        - `limit` object, required
          - `name` 'projectSourceBytes', required
          - `max` integer, required
          - `observed` integer, required
      - object
        - `code` 'project_review_required', required
        - `detail` string, required
      - object
        - `code` 'preview_mismatch_after_remap', required
        - `detail` string, required
  - `items` object[], required
    - `index` integer, required
    - `status` 'waiting_for_source' | 'preparing' | 'held' | 'ready' | 'failed', required
    - `source` object, required
      - `sourceVersionId` string, uuid, required
      - `externalId` string, nullable, required
      - `status` 'queued' | 'inspecting' | 'ready' | 'failed', required
    - `plates` union, required
      - 'all'
      - integer[]
    - `resolvedPlates` integer[], nullable, required
    - `quantity` integer, required
    - `materialMappings` object[], required
      - `sourceSlot` integer, required
      - `material` string, required
      - `color` string, required
    - `guidance` object, required
      - `allowedMaterials` string[], nullable, required
      - `preferredFilaments` object[], nullable, required
        - `sourceSlot` integer
        - `material` string, required
        - `color` string
        - `brand` string
        - `name` string
    - `target` object, required
      - `printerId` string, uuid, required
      - `printerName` string, required
      - `qualification` 'bambu-p1s-0.4-standard-petg-v1', required
      - `printerModel` 'P1S', required
      - `nozzleDiameterMm` 0.4, required
      - `nozzleFlow` 'standard', required
      - `buildSurface` 'textured_pei', required
      - `profiles` object, required
        - `printer` object, required
          - `catalogId` string, uuid, required
          - `name` string, required
        - `process` object, required
          - `catalogId` string, uuid, required
          - `name` string, required
        - `filament` object, required
          - `catalogId` string, uuid, required
          - `name` string, required
    - `failure` object, nullable, required
      - `code` 'source_failed' | 'plate_not_found' | 'no_plates' | 'mapping_slot_not_found' | 'inspection_unreadable', required
      - `sourceError` object
        - `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
      - `plates` integer[]
      - `slots` integer[]
    - `preparedPlates` object[], required
      - `plateId` string, uuid, required
      - `plateNumber` integer, required
      - `runs` integer, required
      - `status` 'preparing' | 'held' | 'ready' | 'failed', required
      - `usedSlots` integer[], required
      - `materialMappings` object[], required
        - `sourceSlot` integer, required
        - `material` 'PETG', required
        - `color` string, required
        - `origin` 'partner' | 'inspection' | 'placeholder', required
      - `holds` union[], required
        - union
          - object
            - `code` 'inspection_review_required', required
            - `reason` string, required
          - object
            - `code` 'unmapped_used_slot', required
            - `slots` integer[], required
          - object
            - `code` 'project_source_too_large', required
            - `limit` object, required
              - …
          - object
            - `code` 'project_review_required', required
            - `detail` string, required
          - object
            - `code` 'preview_mismatch_after_remap', required
            - `detail` string, required
      - `failure` object, nullable, required
        - `code` 'slice_failed', required
        - `sliceCode` string, required
        - `message` string, required
        - `retryable` boolean, required
        - `attempts` integer, required
      - `output` object, nullable, required
        - `outputFileId` string, uuid, required
        - `filename` string, required
        - `bytes` integer, required
        - `sha256` string, required
      - `lineage` object, nullable, required
        - `sourceVersionId` string, uuid, required
        - `sourceSha256` string, required
        - `plateNumber` integer, required
        - `qualification` 'bambu-p1s-0.4-standard-petg-v1', required
        - `buildSurface` 'textured_pei', required
        - `materialMappings` object[], required
          - `sourceSlot` integer, required
          - `material` 'PETG', required
          - `color` string, required
        - `engineSha256` string, required
        - `resolvedProfilesSha256` string, required
        - `derivedInputSha256` string, required
        - `qualifiedProfileSourceHashes` object, required
        - `replacedSettings` object[], required
          - `key` string, required
          - `source` union, required
            - string
            - string[]
            - number
            - boolean
          - `target` union
            - string
            - string[]
            - number
            - boolean
        - `omittedSettings` string[], required
        - `settingFilterPolicy` object, required
          - `hold` string[], required
          - `omit` string[], required
        - `ignoredSettings` string[], required
        - `warnings` object[], required
          - `code` 'custom_instructions_kept' | 'custom_instructions_replaced', required
          - `keys` string[], required
        - `engineFallback` object, nullable, required
          - `authoringVersion` string, nullable, required
          - `selectedVersion` string, required
        - `preview` 'source' | 'engine' | 'none', required
        - `previewFile` string, nullable, required
        - `finalArtifactSha256` string, required

## Other responses

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

## Changes

- **2026-10-30** `f4d2cdd1c9f2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/partner-production/preparations/:preparationId/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/5c27b7de1bed?raw)