FOLIO Data Import

A Python toolkit for bulk importing data into a FOLIO LSP environment. Currently supports:

• MARC records - Import bibliographic and holdings MARC records

• User/patron data - Load user records from JSON Lines format

• Batch operations - Post data to FOLIO using the API

• Data Import diagnostics - Retrieve error logs and failed MARC records from Data Import jobs

What does it do?

FOLIO Data Import provides utilities and tools to help with initial data migrations into FOLIO, as well as ongoing bulk imports.

Key Features

• MARC Import - Load batches of MARC records via FOLIO’s Data Import system using change-manager APIs

• User Import - An alternative to FOLIO’s own user-import API that offers more robust record handling and extended functionality (field protection, service point assignment, etc.)

• Batch Posting - Efficiently post Inventory records to FOLIO using batch APIs

• DI Log Retrieval - Extract error logs and failed MARC records from Data Import jobs for analysis

• Progress Tracking - Real-time progress reporting with Redis support

• Error Reporting - Detailed error logs and failed record tracking

• Flexible Configuration - JSON configuration files for all tools

Quick Links

• Installation Guide - Get started with pip or development setup

• Quick Start Tutorial - Simple examples to get you running

• API Reference - Complete Python API documentation

• Troubleshooting - Common issues and solutions

Contributing

Found a bug? Want to contribute a feature? Check out the Contributing Guide to learn how to help improve FOLIO Data Import.

Found an issue?

Report it on the GitHub Issue tracker

---

Mar 26, 2026 | 236 words | 1 min read