---
title: "POST /v1/ingestor/scans"
method: POST
path: "/v1/ingestor/scans"
---

# POST /v1/ingestor/scans

`POST /v1/ingestor/scans`

## Request body

- object
  - `siteId` string, uuid, required
  - `customerScanId` string, required
  - `scanTimestampUtc` string, required
  - `handlingUnitId` string, required
  - `shipmentId` string
  - `scanMetadata` object, required
  - `captures` object[], required
    - `cameraId` string, uuid, required
    - `frameRequestId` string, required
    - `captureTimestampUtc` string, required
    - `mimeType` string, required
    - `ingestorMetadata` object, required
      - `cameraType` string, required
      - `timeOffsetMs` integer
      - `toleranceSeconds` number
      - `captureLatencyMs` integer
      - `targetTimestampUtc` string
      - `captureTimestampSource` string
      - `receivedAtUtc` string
      - `availableAtUtc` string
      - `rawBlobPath` string
      - `calibrationVersion` string
      - `coverageVersion` string
    - `intermediateFrames` object[]
      - `offsetMs` integer, required
      - `frameRequestId` string, required
      - `captureTimestampUtc` string, required
      - `mimeType` 'image/jpeg', required
      - `ingestorMetadata` object, required
        - `cameraType` string, required
        - `timeOffsetMs` integer
        - `toleranceSeconds` number
        - `captureLatencyMs` integer
        - `targetTimestampUtc` string
        - `captureTimestampSource` string
        - `receivedAtUtc` string
        - `availableAtUtc` string
        - `rawBlobPath` string
        - `calibrationVersion` string
        - `coverageVersion` string

## Response `200`

Default Response

## Changes

- **2026-09-19** `e47f38f712d0` — 2 breaking
  - removed `subschema #1, subschema #2` from the `captures/items/intermediateFrames/items/offsetMs` request property `oneOf` list
  - the `captures/items/intermediateFrames/items/offsetMs` request property type changed from no type to `integer`
- **2026-09-16** `c5284fb49979` — 1 info
  - added the new optional request property `captures/items/intermediateFrames`
- **2026-09-15** `7f2d3a8bff94` — 2 info
  - added the new optional request property `captures/items/ingestorMetadata/availableAtUtc`
  - added the new optional request property `captures/items/ingestorMetadata/receivedAtUtc`
- **2026-09-02** `c421c9d210ae` — 2 info
  - added the new optional request property `captures/items/ingestorMetadata/calibrationVersion`
  - added the new optional request property `captures/items/ingestorMetadata/coverageVersion`

[Change history](https://skmtc.dev/transload/apis/pipeline-backend/changes/v1/ingestor/scans/post.md)

---

[API](https://skmtc.dev/transload/apis/pipeline-backend.md) · [All operations](https://skmtc.dev/transload/apis/pipeline-backend/llms.txt) · [OpenAPI document](https://skmtc.dev/transload/apis/pipeline-backend/revisions/932b1b877e8b?raw)