---
title: "Imports"
description: "Bulk CSV imports of historic orders."
url: https://docs.filemonk.io/v2/api-reference/imports/
api: "API v2 reference"
---

# Imports

Bulk CSV imports of historic orders.

## The import object

- `id` (string, nullable, required): e.g. `de0d7253-b5ed-42cc-921b-e1d90bf2cd76`
- `name` (string, nullable, required): e.g. `orders-import.csv`
- `status` (string, nullable, required): e.g. `completed`
- `rows` (object, required)
  - `total` (integer, nullable, required): e.g. `1`
  - `completed` (integer, nullable, required): e.g. `1`
  - `failed` (integer, nullable, required): e.g. `0`
- `completed_at` (string, nullable, required): e.g. `2026-10-30T23:03:25Z`
- `created_at` (string, nullable, required): e.g. `2026-10-30T23:03:04Z`
- `failed_rows` (array of anys, required)

```json
{
  "id": "de0d7253-b5ed-42cc-921b-e1d90bf2cd76",
  "name": "orders-import.csv",
  "status": "completed",
  "rows": {
    "total": 1,
    "completed": 1,
    "failed": 0
  },
  "completed_at": "2026-10-30T23:03:25Z",
  "created_at": "2026-10-30T23:03:04Z",
  "failed_rows": []
}
```

## Endpoints

- `GET /imports`: [List imports](https://docs.filemonk.io/v2/api-reference/imports/list-imports.md)
- `POST /imports`: [Create an import](https://docs.filemonk.io/v2/api-reference/imports/create-an-import.md)
- `GET /imports/{id}`: [Get an import](https://docs.filemonk.io/v2/api-reference/imports/get-an-import.md)
- `POST /imports/preview`: [Preview an import](https://docs.filemonk.io/v2/api-reference/imports/preview-an-import.md)