diff --git a/api-references/payments/billpay/api-integration.json b/api-references/payments/billpay/api-integration.json
index be19d498..18b7fa97 100644
--- a/api-references/payments/billpay/api-integration.json
+++ b/api-references/payments/billpay/api-integration.json
@@ -9214,8 +9214,14 @@
                               },
                               "status": {
                                 "type": "string",
-                                "description": "Current biller status as received from BBPS MDM.",
-                                "example": "ACTIVE"
+                                "description": "Current biller lifecycle status as received from BBPS MDM.\n\nACTIVE: Biller is live on the network and available for bill fetch and payment.\nDEACTIVATED: Biller has been deactivated and is not available for new bill fetches or payments.\nPENDING_DEACTIVATION: Deactivation is in progress; treat the biller as transitioning away from ACTIVE.\nPENDING_DELETE: Deletion is pending in MDM before the biller record is fully removed.",
+                                "example": "ACTIVE",
+                                "enum": [
+                                  "ACTIVE",
+                                  "DEACTIVATED",
+                                  "PENDING_DEACTIVATION",
+                                  "PENDING_DELETE"
+                                ]
                               },
                               "interchangeFee": {
                                 "type": "array",