---
title: "List import files"
method: POST
path: "/import/import-files"
tags: ["Document AI — Import & Migration"]
---

# List import files

`POST /import/import-files`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/import/import-files`
- Auth: HTTP bearer

Return the paginated file list for an import job.

## Request body

- object
  - `job_id` integer, required: Import job ID whose file list is returned.
  - `skip` integer: 0-based offset into the merged live + snapshot file list. When set (including 0), skip wins over page.
  - `limit` integer: Page size (default 50, max 500).
  - `page` integer: 1-based page (used when skip is omitted). Offset = (page-1)*limit.
  - `status` 'pending' | 'downloading' | 'processing' | 'completed' | 'failed' | 'skipped' | 'imported': Optional file-status filter: pending, downloading, processing, completed, failed, skipped. Alias imported = completed.

## Response `200`

Success

- object: Import files
  - `status` 'success' | 'error': Request status (ok/error)
  - `message` string: Status message
  - `files` object[]: List of files
    - `filename` string: Filename
    - `status` string: Request status (ok/error)
    - `pofid` string: PaperOffice File ID
    - `error` string: Fehlerdetails falls vorhanden
  - `processing_time` string: Request processing time (e.g. "123.45ms")
  - `data` string: Data
  - `total` string: Total
  - `page` string: Page
  - `limit` string: Limit
  - `total_pages` string: Total pages
  - `job_id` string: Job id
  - `files_skipped` string: Files skipped
  - `retried_files` string: Retried files

## Other responses

- `4XX`: Error
- `5XX`: Error

---

[API](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api.md) · [All operations](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/paperoffice/apis/paperoffice-ai-api/revisions/c6a6228a4509?raw)