---
title: "List Import Histories"
method: GET
path: "/imports/history"
tags: ["imports"]
---

# List Import Histories

`GET /imports/history`

List import history records for a workspace.

Args:
    workspace_id: Workspace ID to filter import histories
    limit: Optional limit on number of records to return (for Recent Imports sidebar)
    db: Database session
    current_user: Authenticated user

Returns:
    List of ImportHistoryResponse records

Raises:
    HTTPException: If workspace doesn't exist or access denied

## Query parameters

- `workspace_id` string, uuid, required
- `limit` integer, nullable

## Response `200`

Successful Response

- ImportHistoryResponse[]
  - `id` string, uuid, required — Import history record ID
  - `workspace_id` string, uuid, required — Workspace ID
  - `username` string, required — Username who created the import
  - `filename` string, required — Import filename
  - `created_at` string, date-time, required — Creation timestamp
  - `data` object, nullable — Tabular dataframe data (only in detailed view)
  - `metadata` object, nullable — Import metadata with status and files (in list and detailed view)

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Content
- `500` — Internal Server Error

---

[API](https://skmtc.net/hf/apis/extralit-v1.md) · [All operations](https://skmtc.net/hf/apis/extralit-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hf/extralit-v1/revisions/e9da3a893a88/schema)