From 940108ed340e72862daf6b4305798bd7e8383e78 Mon Sep 17 00:00:00 2001
From: paige <31039783+YevenLourance@users.noreply.github.com>
Date: Thu, 15 Jan 2026 13:14:29 +1100
Subject: [PATCH] doc(promotions): PROMO-1393 add number of codes use

add number of codes use fields
---
 reference/promotions.v3.yml | 10 ++++++++++
 1 file changed, 10 insertions(+)

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.'