---
title: "List Imports"
method: GET
path: "/api/v1/imports"
tags: ["imports"]
---

# List Imports

`GET /api/v1/imports`

## Query parameters

- `cursor` string, nullable
- `limit` integer

## Response `200`

Successful Response

- ImportListResponse
  - `items` Import[], required
    - `id` string, uuid, required
    - `project_id` string, uuid, nullable
    - `source_kind` 'rudus' | 'osp' | 'tpx', required
    - `status` 'uploading' | 'converting' | 'ready_for_plan_review' | 'applying_plan' | 'validating' | 'creating_graph' | 'ingesting_pdfs' | 'calibrating' | 'creating_takeoff' | 'inserting_measurements' | 'inserting_annotations' | 'verifying' | 'ready_for_review' | 'confirmed' | 'failed' | 'reverting' | 'reverted', required
    - `storage_path` string, required
    - `progress` object
    - `report` object
    - `plan` ImportPlan
      - `summary` PlanSummary, required
        - `counts` object
        - `extensions_matched` string[]
        - `extensions_created` string[]
        - `unmapped` object[]
        - `converter` object
      - `auto_fixed` PlanIssue[]
        - `issue_id` string, required
        - `severity` 'error' | 'warning', required
        - `code` string, required
        - `message` string, required
        - `refs` EntityRef[]
          - `kind` 'condition' | 'measurement' | 'drawing', required
          - `file_id` string, uuid, required
          - `label` string, required
        - `skippable` boolean
      - `warnings` PlanIssue[]
        - `issue_id` string, required
        - `severity` 'error' | 'warning', required
        - `code` string, required
        - `message` string, required
        - `refs` EntityRef[]
          - `kind` 'condition' | 'measurement' | 'drawing', required
          - `file_id` string, uuid, required
          - `label` string, required
        - `skippable` boolean
      - `errors` PlanIssue[]
        - `issue_id` string, required
        - `severity` 'error' | 'warning', required
        - `code` string, required
        - `message` string, required
        - `refs` EntityRef[]
          - `kind` 'condition' | 'measurement' | 'drawing', required
          - `file_id` string, uuid, required
          - `label` string, required
        - `skippable` boolean
    - `skips` SkipRecord
      - `skip_issue_ids` string[], required
      - `refs` EntityRef[], required
        - `kind` 'condition' | 'measurement' | 'drawing', required
        - `file_id` string, uuid, required
        - `label` string, required
      - `dropped` object
      - `skip_affected` SkipScope[]
        - `scope` 'project' | 'condition' | 'sheet', required
        - `condition_id` string, uuid, nullable
        - `page_id` string, uuid, nullable
      - `reviewed_path` string, nullable
      - `reviewed_sha256` string, nullable
    - `error` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `next_cursor` string, nullable

## Other responses

- `4XX` — Client Error
- `5XX` — Server Error

---

[API](https://skmtc.dev/rudus/apis/rudus-api.md) · [All operations](https://skmtc.dev/rudus/apis/rudus-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/rudus/rudus-api/revisions/f149124a4d80/schema)