---
title: "Scan for unprocessed raw data and queue it for ingestion"
method: POST
path: "/raw_data/scan"
tags: ["Raw Data"]
---

# Scan for unprocessed raw data and queue it for ingestion

`POST /raw_data/scan`

Queue every not-yet-processed raw-data record in a project.

Designed to be called on a schedule. Returns immediately after enqueuing;
parsing and validation happen on the task worker. Safe to call
concurrently — each record is claimed before it is enqueued, so overlapping
runs cannot process the same file twice.

## Query parameters

- `project_id` string, required — Project to scan

## Response `200`

Successful Response

- ScanResponse — Result of a scan sweep over a project's pending raw-data records.
  - `scanned` integer, required — Pending records examined.
  - `queued` integer, required — Records enqueued for ingestion.
  - `raw_data_ids` string[] — The records that were enqueued.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/ionworks/apis/fastapi.md) · [All operations](https://skmtc.dev/ionworks/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ionworks/fastapi/revisions/7337a3cbdaf2/schema)