---
title: "List raw-data records awaiting review"
method: GET
path: "/raw_data/needs-review"
tags: ["Raw Data"]
---

# List raw-data records awaiting review

`GET /raw_data/needs-review`

List records parked on validation findings a human must resolve.

## Query parameters

- `project_id` string, required — Project to list
- `limit` integer
- `offset` integer

## Response `200`

Successful Response

- PaginatedResponseRawData
  - `items` RawData[], required
    - `project_id` string, required — Owning project ID (required).
    - `name` string, required — User-provided label for the raw file.
    - `source` string, nullable — Free-text provenance: where this raw file came from (a URL, DOI, S3 URI, vendor/cycler export description, etc.).
    - `metadata` object — Loose free-form metadata.
    - `id` string, required — Unique identifier.
    - `organization_id` string, required — Owning organization.
    - `filename` string, required — Original uploaded filename.
    - `content_type` string, nullable — MIME type, if known.
    - `size_bytes` integer, nullable — File size in bytes.
    - `storage_path` string, required — Path within the raw-data bucket.
    - `processing_status` 'pending' | 'queued' | 'processing' | 'needs_review' | 'awaiting_cell' | 'done' | 'failed' — Ingestion lifecycle: pending | queued | processing | needs_review | awaiting_cell | done | failed. See src.pydantic_models.raw_data_ingestion for what each means.
    - `processing_error` string, nullable — Terminal ingestion failure message, if any.
    - `processed_at` string, date-time, nullable — When ingestion last reached a terminal state.
    - `reader` string, nullable — Cycler format detected on parse (arbin, maccor, ...).
    - `created_by` string, nullable — User ID of the uploader.
    - `created_at` string, date-time, required — Creation timestamp.
    - `updated_at` string, date-time, required — Last update timestamp.
  - `count` integer, required
  - `total` integer, required

## 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)