diff --git a/reference/promotions.v3.yml b/reference/promotions.v3.yml
index ce794ead0..aeae4397a 100644
--- a/reference/promotions.v3.yml
+++ b/reference/promotions.v3.yml
@@ -606,6 +606,14 @@ components:
                 - BULK
               description: The type of the coupon promotion, whether it will have single or multiple codes.
               example: BULK
+            number_of_codes:
+              type: integer
+              description: The total number of coupon codes for this promotion.
+              example: 1
+            number_of_used_codes:
+              type: integer
+              description: The number of coupon codes that have been used at least once.
+              example: 0
       required:
         - id
         - name
@@ -623,6 +631,8 @@ components:
         - can_be_used_with_other_promotions
         - coupon_overrides_automatic_when_offering_higher_discounts
         - coupon_type
+        - number_of_codes
+        - number_of_used_codes
     PatchAutomaticPromotion:
       title: Patch Automatic Promotion
       description: 'A Partial **Automatic Promotion** that contains properties to patch.'