---
title: "Get a raw-data record"
method: GET
path: "/raw_data/{raw_data_id}"
tags: ["Raw Data"]
---

# Get a raw-data record

`GET /raw_data/{raw_data_id}`

Retrieve a single raw-data record by ID.

## Path parameters

- `raw_data_id` string, required

## Response `200`

Successful Response

- RawData — A raw-data record as returned by the API.
  - `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.

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