diff --git a/jsonrpc/src/errors/errors.json b/jsonrpc/src/errors/errors.json
index 46a261c..d789e24 100644
--- a/jsonrpc/src/errors/errors.json
+++ b/jsonrpc/src/errors/errors.json
@@ -1,9 +1,13 @@
 {
   "ContentNotFoundError": {
     "code": -32099,
+    "message": "content not found"
+  },
+  "ContentNotFoundErrorWithTrace": {
+    "code": -32098,
     "message": "content not found",
     "data": {
       "$ref": "#/components/schemas/traceResultObject"
     }
-  }  
+  }    
 }
\ No newline at end of file
diff --git a/jsonrpc/src/methods/beacon.json b/jsonrpc/src/methods/beacon.json
index ca709fa..8b6bb53 100644
--- a/jsonrpc/src/methods/beacon.json
+++ b/jsonrpc/src/methods/beacon.json
@@ -157,7 +157,10 @@
     ],
     "result": {
       "$ref": "#/components/contentDescriptors/TraceRecursiveFindContentResult"
-    }
+    },
+    "errors":[{
+      "$ref": "#/components/errors/ContentNotFoundErrorWithTrace"
+    }]
   },
   {
     "name": "portal_beaconStore",
diff --git a/jsonrpc/src/methods/history.json b/jsonrpc/src/methods/history.json
index fd1ff8b..1191d83 100644
--- a/jsonrpc/src/methods/history.json
+++ b/jsonrpc/src/methods/history.json
@@ -149,7 +149,10 @@
     ],
     "result": {
       "$ref": "#/components/contentDescriptors/TraceRecursiveFindContentResult"
-    }
+    },
+    "errors":[{
+      "$ref": "#/components/errors/ContentNotFoundErrorWithTrace"
+    }]
   },
   {
     "name": "portal_historyStore",
diff --git a/jsonrpc/src/methods/state.json b/jsonrpc/src/methods/state.json
index 7a6b149..bec037c 100644
--- a/jsonrpc/src/methods/state.json
+++ b/jsonrpc/src/methods/state.json
@@ -139,6 +139,21 @@
       "$ref": "#/components/contentDescriptors/RecursiveFindContentResult"
     }
   },
+  {
+    "name": "portal_stateTraceRecursiveFindContent",
+    "summary": "Look up a target content key in the network and get tracing data",
+    "params": [
+      {
+        "$ref": "#/components/contentDescriptors/ContentKey"
+      }
+    ],
+    "result": {
+      "$ref": "#/components/contentDescriptors/TraceRecursiveFindContentResult"
+    },
+    "errors":[{
+      "$ref": "#/components/errors/ContentNotFoundErrorWithTrace"
+    }]
+  },
   {
     "name": "portal_stateStore",
     "summary": "Store state content key with content data",