diff --git a/dev-docs/publisher-api-reference/getConsentMetadata.md b/dev-docs/publisher-api-reference/getConsentMetadata.md
new file mode 100644
index 0000000000..abdae9bd1a
--- /dev/null
+++ b/dev-docs/publisher-api-reference/getConsentMetadata.md
@@ -0,0 +1,25 @@
+---
+layout: api_prebidjs
+title: pbjs.getConsentMetadata()
+description: 
+---
+
+
+The `getConsentMetadata()` function will return basic information about the status of supported (and configured!) consent content within Prebid.
+
+```
+pbjs.getConsentMetadata() // returns e.g.
+{
+    "coppa": false,
+    "gdpr": {
+        "apiVersion": 2,
+        "consentStringSize": 100,
+        "gdprApplies": true,
+        "generatedAt": 1644358143306
+    },
+    "usp": {
+        "generatedAt": 1644358143306,
+        "usp": "1YYY"
+    }
+}
+```
\ No newline at end of file