diff --git a/docs/api.md b/docs/api.md
index 77ea591..ff80d54 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -65,7 +65,10 @@ def save(self, file_output=None):
     """Export state (definition+data) into a file"""
 
 def load(self, file_input=None, file_content=None):
-    """Load previously exported state from a file"""
+    """
+    Load previously exported state from a file.
+    Return the proxy id remap which is a dict with proxy id's found in the provided state as keys and the corresponding freshly created proxy id's as values.
+    """
 ```
 
 __Commit / Reset__
diff --git a/trame_simput/core/proxy.py b/trame_simput/core/proxy.py
index 67189e9..5495e32 100644
--- a/trame_simput/core/proxy.py
+++ b/trame_simput/core/proxy.py
@@ -857,6 +857,8 @@ def load(self, file_input=None, file_content=None):
         )
         self._emit("created", ids=_new_ids)
 
+        return _id_remap
+
     # -------------------------------------------------------------------------
     # Commit / Reset
     # -------------------------------------------------------------------------