diff --git a/scripts/ai/API b/scripts/ai/API
index 1f0f653..923e150 100644
--- a/scripts/ai/API
+++ b/scripts/ai/API
@@ -46,6 +46,18 @@ minbrakedist()
   -- Returns the minimum required braking distance assuming all goes well.
     -- return number distance needed to brake.
 
+armor()
+  -- Returns the total amount of armor left.
+
+shield()
+  -- Returns the total amount of shield left.
+
+parmor()
+  -- Returns the percentage of armor remaining.
+
+pshield()
+  -- Returns the percentage of shield remaining.
+
 // ================
 // BOOLEAN!
 // ================