Get Imports Summary

GET /v1/integration/:id/import-history

Returns a paginated list of recent import runs. Each item includes the run result, timing, the triggering user, and the configuration used (mapping, filters, CSV options, etc.).

Response Example

{
  "data": [
    {
      "result": {
        "status": true,
        "message": "Successfully imported 4 item(s).",
        "total": 4,
        "successCount": 4,
        "skippedCount": 0,
        "failedCount": 0,
        "failed": [],
        "skipped": []
      },
      "date": {
        "started": "2025-10-31T11:45:48.968Z",
        "finished": "2025-10-31T11:45:49.114Z"
      },
      "user": {
        "id": "user-id-1",
        "username": "user@example.com"
      },
      "_id": "import-run-id-1",
      "tenant": "tenant-id-1",
      "config": {
        "csvOptions": {
          "fieldDelimiter": ",",
          "valueDelimiter": ","
        },
        "filter": {
          "all": true,
          "ids": [0, 1, 2, 3, 4]
        },
        "importOptions": {
          "isSubscription": false,
          "isActive": true,
          "salesChannels": ["marketplace"],
          "matchingField": "sku"
        },
        "name": "Example Import Job.csv",
        "tenant": "tenant-id-1",
        "isGlobal": false,
        "resource": "products",
        "format": "csv",
        "fieldMapping": {
          "sku": "sku",
          "name": "name",
          "description": "description",
          "id": "id"
        },
        "_id": "import-config-id-1",
        "created": "2025-10-31T11:45:48.971Z",
        "updated": "2025-10-31T11:45:48.971Z"
      },
      "created": "2025-10-31T11:45:48.971Z",
      "updated": "2025-10-31T11:45:49.120Z",
      "__v": 0
    },
    {
      "result": {
        "status": true,
        "success": 100,
        "skipped": [0],
        "errors": 0,
        "failed": []
      },
      "date": {
        "started": "2025-09-01T09:13:37.593Z",
        "finished": "2025-09-01T09:13:44.663Z"
      },
      "user": {
        "id": "user-id-2",
        "username": "operator@example.com"
      },
      "_id": "import-run-id-2",
      "tenant": "tenant-id-1",
      "config": {
        "csvOptions": {
          "fieldDelimiter": ";",
          "valueDelimiter": ","
        },
        "filter": {
          "all": true,
          "ids": []
        },
        "importOptions": {
          "isSubscription": false,
          "isActive": true,
          "salesChannels": ["shop"],
          "matchingField": "vendor_sku"
        },
        "name": "Example Supplier",
        "tenant": "tenant-id-1",
        "resource": "products",
        "format": "csv",
        "fieldMapping": {
          "name": "ProductName",
          "price": "Price",
          "media": "ImageUrl",
          "vendor_sku": "VendorSKU"
        },
        "propertyMapping": {
          "Type": ["SFP", "QSFP28"],
          "Length": ["10km", "40km"]
        },
        "_id": "import-config-id-2",
        "created": "2025-09-01T09:13:37.595Z",
        "updated": "2025-09-01T09:13:37.595Z",
        "isGlobal": false
      },
      "created": "2025-09-01T09:13:37.595Z",
      "updated": "2025-09-01T09:13:44.663Z",
      "__v": 0
    }
  ],
  "metadata": {
    "offset": 0,
    "limit": 100,
    "total": 2
  }
}