Add requests_per_minute to quota response

makowskid · claude · makowskid · commit 976f6b5bafb3 · 2026-02-06T14:00:55.000+07:00
The /quota endpoint now returns requests_per_minute (int). Added the
field to SubscriptionInfo DTO, quota() method, and documented in README.

Co-Authored-By: Claude Opus 4.6 &lt;noreply@anthropic.com&gt;
diff --git a/README.md b/README.md
@@ -10,6 +10,34 @@ See more at [SharpAPI.com Website &raquo;](https://sharpapi.com/)
 
 ---
 
+## Quota Method
+
+The `quota()` method returns a `SubscriptionInfo` DTO with the following fields:
+
+| Field | Type | Description |
+|---|---|---|
+| `timestamp` | `Carbon` | Timestamp of the subscription check |
+| `on_trial` | `bool` | Whether the account is on a trial period |
+| `trial_ends` | `Carbon` | End date of the trial period |
+| `subscribed` | `bool` | Whether the user is currently subscribed |
+| `current_subscription_start` | `Carbon` | Start of the current subscription period |
+| `current_subscription_end` | `Carbon` | End of the current subscription period |
+| `current_subscription_reset` | `Carbon` | Quota reset timestamp |
+| `subscription_words_quota` | `int` | Total word quota for the period |
+| `subscription_words_used` | `int` | Words used in the current period |
+| `subscription_words_used_percentage` | `float` | Percentage of word quota used |
+| `requests_per_minute` | `int` | Maximum API requests allowed per minute |
+
+```php
+$client = new SharpApiClient('your-api-key');
+$quota = $client->quota();
+
+echo $quota->subscription_words_quota;
+echo $quota->requests_per_minute;
+```
+
+---
+
 ## Credits
 
 - [A2Z WEB LTD](https://github.com/a2zwebltd)
diff --git a/src/Client/SharpApiClient.php b/src/Client/SharpApiClient.php
@@ -170,7 +170,8 @@ public function quota(): ?SubscriptionInfo
             current_subscription_reset: new Carbon($info['current_subscription_reset']),
             subscription_words_quota: $info['subscription_words_quota'],
             subscription_words_used: $info['subscription_words_used'],
-            subscription_words_used_percentage: $info['subscription_words_used_percentage']
+            subscription_words_used_percentage: $info['subscription_words_used_percentage'],
+            requests_per_minute: $info['requests_per_minute']
         );
     }
 
diff --git a/src/DTO/SubscriptionInfo.php b/src/DTO/SubscriptionInfo.php
@@ -23,6 +23,7 @@ class SubscriptionInfo
      * @param int $subscription_words_used Number of words used in the current subscription period.
      * @param float $subscription_words_used_percentage Percentage of the word quota used
      *                                                     in the current subscription period.
+     * @param int $requests_per_minute Maximum number of API requests allowed per minute.
      */
     public function __construct(
         public Carbon $timestamp,
@@ -34,7 +35,8 @@ public function __construct(
         public Carbon $current_subscription_reset,
         public int    $subscription_words_quota,
         public int    $subscription_words_used,
-        public float  $subscription_words_used_percentage
+        public float  $subscription_words_used_percentage,
+        public int    $requests_per_minute
     )
     {
     }
@@ -57,6 +59,7 @@ public function toArray(): array
             'subscription_words_quota' => $this->subscription_words_quota,
             'subscription_words_used' => $this->subscription_words_used,
             'subscription_words_used_percentage' => $this->subscription_words_used_percentage,
+            'requests_per_minute' => $this->requests_per_minute,
         ];
     }
 }

Original file line number	Diff line number	Diff line change
`@@ -170,7 +170,8 @@ public function quota(): ?SubscriptionInfo`
`170`	`170`	`current_subscription_reset: new Carbon($info['current_subscription_reset']),`
`171`	`171`	`subscription_words_quota: $info['subscription_words_quota'],`
`172`	`172`	`subscription_words_used: $info['subscription_words_used'],`
`173`		`- subscription_words_used_percentage: $info['subscription_words_used_percentage']`
	`173`	`+ subscription_words_used_percentage: $info['subscription_words_used_percentage'],`
	`174`	`+ requests_per_minute: $info['requests_per_minute']`
`174`	`175`	`);`
`175`	`176`	`}`
`176`	`177`
Original file line number	Diff line number	Diff line change
`@@ -23,6 +23,7 @@ class SubscriptionInfo`
`23`	`23`	`* @param int $subscription_words_used Number of words used in the current subscription period.`
`24`	`24`	`* @param float $subscription_words_used_percentage Percentage of the word quota used`
`25`	`25`	`* in the current subscription period.`
	`26`	`+ * @param int $requests_per_minute Maximum number of API requests allowed per minute.`
`26`	`27`	`*/`
`27`	`28`	`public function __construct(`
`28`	`29`	`public Carbon $timestamp,`
`@@ -34,7 +35,8 @@ public function __construct(`
`34`	`35`	`public Carbon $current_subscription_reset,`
`35`	`36`	`public int $subscription_words_quota,`
`36`	`37`	`public int $subscription_words_used,`
`37`		`- public float $subscription_words_used_percentage`
	`38`	`+ public float $subscription_words_used_percentage,`
	`39`	`+ public int $requests_per_minute`
`38`	`40`	`)`
`39`	`41`	`{`
`40`	`42`	`}`
`@@ -57,6 +59,7 @@ public function toArray(): array`
`57`	`59`	`'subscription_words_quota' => $this->subscription_words_quota,`
`58`	`60`	`'subscription_words_used' => $this->subscription_words_used,`
`59`	`61`	`'subscription_words_used_percentage' => $this->subscription_words_used_percentage,`
	`62`	`+ 'requests_per_minute' => $this->requests_per_minute,`
`60`	`63`	`];`
`61`	`64`	`}`
`62`	`65`	`}`