From 7e00d0b28a8543b12fff61aafbacdf962c3ef7df Mon Sep 17 00:00:00 2001
From: Eduard Hura <eduard.hura@railsware.com>
Date: Fri, 15 May 2026 09:23:27 +0300
Subject: [PATCH] MT-21887: Expose email campaigns usage in account billing API

---
 specs/account-management.openapi.yml | 29 ++++++++++++++++++++++++++--
 1 file changed, 27 insertions(+), 2 deletions(-)

diff --git a/specs/account-management.openapi.yml b/specs/account-management.openapi.yml
index 3cbb376..c36acc7 100644
--- a/specs/account-management.openapi.yml
+++ b/specs/account-management.openapi.yml
@@ -874,7 +874,7 @@ paths:
     get:
       operationId: getAccountBillingUsage
       summary: Get current billing cycle usage
-      description: Get current billing cycle usage for Email Sandbox and Email Sending (Email API/SMTP).
+      description: Get current billing cycle usage for Email Sandbox, Email Sending (Email API/SMTP), and Email Marketing.
       tags:
         - Billing
       x-codeSamples:
@@ -946,7 +946,7 @@ paths:
             var response = client.generalApi().billing().getCurrentBillingCycleUsage(accountId);
       responses:
         '200':
-          description: Returns an object with current billing cycle usage for Sandbox and Email Sending (Email API/SMTP) if available.
+          description: Returns an object with current billing cycle usage for Sandbox, Email Sending (Email API/SMTP), and Email Marketing if available.
           content:
             application/json:
               schema:
@@ -1004,6 +1004,24 @@ paths:
                                 type: integer
                               limit:
                                 type: integer
+                  marketing:
+                    type: object
+                    properties:
+                      plan:
+                        type: object
+                        properties:
+                          name:
+                            type: string
+                      usage:
+                        type: object
+                        properties:
+                          sent_messages_count:
+                            type: object
+                            properties:
+                              current:
+                                type: integer
+                              limit:
+                                type: integer
               example:
                 billing:
                   cycle_start: '2024-02-15T21:11:59.624Z'
@@ -1025,6 +1043,13 @@ paths:
                     sent_messages_count:
                       current: 6789
                       limit: 10000
+                marketing:
+                  plan:
+                    name: Marketing Pro
+                  usage:
+                    sent_messages_count:
+                      current: 1500
+                      limit: 10000
         '401':
           $ref: '#/components/responses/UNAUTHENTICATED'
         '403':