Import & Export API

Programmatic endpoints for backing up and restoring user tracking data.

1. Export Data Backup

GET /api/v1/export Exports a full JSON snapshot of all tracking lists and associated catalog references belonging to the current user.

Authorization: Bearer <token>

Returns JSON document containing full user tracking state.

POST /api/v1/import Imports tracking lists and adds missing catalog items.

JSON payload matching the export schema format.

{
  "imported_categories": ["movies", "tvshows", "books"],
  "total_records_processed": 142,
  "status": "success"
}