sunnybhara · mintlify · Apr 13, 2026
diff --git a/authentication.mdx b/authentication.mdx
@@ -22,7 +22,7 @@ Authorization: Bearer nawa_live_sk_xxx
 <CardGroup cols={2}>
   <Card title="Free" icon="flask">
     **Free, no credit card required.**
-    - 100 lifetime requests
+    - 100 lifetime requests per account (shared across all free keys)
     - 14-day key expiry
     - Uses real AI models (same accuracy)
     - Rate limit: 10 requests/minute

diff --git a/billing.mdx b/billing.mdx
@@ -16,13 +16,13 @@ NAWA uses a prepaid credit system.
 
 <CardGroup cols={1}>
   <Card title="Free tier" icon="flask">
-    - **100 lifetime requests** per free key (`nawa_test_sk_`)
+    - **100 lifetime requests per account** across all free keys (`nawa_test_sk_`)
     - 14-day key expiry
     - No credit card required
     - Uses real AI models -- same accuracy as paid
     - Rate limit: 10 requests/minute
     - Free endpoints (health, usage, analytics, comments, feedback) do not count toward the 100 limit
-    - When exhausted: create a new free key or purchase credits for a live key
+    - When exhausted: purchase credits for a live key
   </Card>
 </CardGroup>
 
@@ -82,7 +82,7 @@ When your credit balance reaches 0:
 
 - All paid endpoints return `402 insufficient_credits`
 - Free endpoints continue to work normally
-- Free keys (`nawa_test_sk_`) are unaffected -- they use their own 100-request pool
+- Free keys (`nawa_test_sk_`) are unaffected -- they use their own 100-request-per-account pool
 - Purchase any credit pack to restore access immediately
 
 <Warning>
@@ -114,7 +114,7 @@ Refunds for unused credits are processed to the original payment method within 5
 
 <AccordionGroup>
   <Accordion title="Do free key requests consume my paid credits?">
-    No. Free keys (`nawa_test_sk_`) have their own pool of 100 lifetime requests. Paid credits are only consumed by live keys (`nawa_live_sk_`).
+    No. Free keys (`nawa_test_sk_`) have their own pool of 100 lifetime requests per account. Paid credits are only consumed by live keys (`nawa_live_sk_`).
   </Accordion>
   <Accordion title="Do credits expire?">
     No. Credits never expire. Use them at your own pace.

diff --git a/errors.mdx b/errors.mdx
@@ -219,16 +219,16 @@ You've exceeded the rate limit for your current tier.
   </Accordion>
 
   <Accordion title="sandbox_exhausted">
-    **Cause:** You've used all 100 lifetime requests on your free key.
+    **Cause:** You have used all 100 free sandbox requests on your account. This limit is enforced across all of your free keys, including revoked and expired ones. Creating new free keys does not reset the counter.
 
-    **Fix:** Buy credits to unlock a live key.
+    **Fix:** Buy credits to continue making API calls.
 
     ```json
     {
       "type": "rate_limit_error",
       "code": "sandbox_exhausted",
-      "message": "Free key lifetime limit of 100 requests reached.",
-      "suggested_action": "Buy credits to create a live API key at trynawa.com/developers/keys."
+      "message": "You have used all 100 free sandbox requests on this account.",
+      "suggested_action": "Buy credits to continue making API calls."
     }
     ```
   </Accordion>

diff --git a/introduction.mdx b/introduction.mdx
@@ -59,7 +59,7 @@ NAWA is the language intelligence platform for Arabic and English. Classify comm
 | Cost per moderate | $0.004 |
 | Cost per report (Basic) | $0.50 |
 | Cost per report (Pro) | $1.50 |
-| Free tier | 100 requests, no credit card |
+| Free tier | 100 requests per account, no credit card |
 | Uptime SLA | 99.9% |
 
 ## Quick taste

diff --git a/quickstart.mdx b/quickstart.mdx
@@ -13,7 +13,7 @@ Get up and running with the NAWA classification API in three steps.
     Go to [trynawa.com/developers/keys](https://trynawa.com/developers/keys) to create your free API key. Sign in with Google or email  -  no credit card required.
 
     <Note>
-      Free keys (`nawa_test_sk_xxx`) require no credit card. Limited to 100 lifetime requests and 14-day expiry. They use real AI models  -  same accuracy as paid keys.
+      Free keys (`nawa_test_sk_xxx`) require no credit card. Limited to 100 lifetime requests per account (shared across all your free keys) and 14-day expiry. They use real AI models  -  same accuracy as paid keys.
     </Note>
   </Step>
 

diff --git a/rate-limits.mdx b/rate-limits.mdx
@@ -16,7 +16,7 @@ NAWA enforces per-minute rate limits on each API key to ensure fair usage and pl
 | **Enterprise+** | 1,000 | Contact [sales@trynawa.com](mailto:sales@trynawa.com) |
 
 <Note>
-  Free keys are rate-limited to 10 requests/minute and have a hard cap of 100 lifetime requests. Live keys start at the Growth tier (120/min). Enterprise tiers are available on request -- contact [sales@trynawa.com](mailto:sales@trynawa.com).
+  Free keys are rate-limited to 10 requests/minute and have a hard cap of 100 lifetime requests per account (shared across all free keys, including revoked ones). Live keys start at the Growth tier (120/min). Enterprise tiers are available on request -- contact [sales@trynawa.com](mailto:sales@trynawa.com).
 </Note>
 
 ## Rate limit headers
-Original file line number
+Diff line change
@@ Expand Up @@
         Go to [trynawa.com/developers/keys](https://trynawa.com/developers/keys) to create your free API key. Sign in with Google or email  -  no credit card required.
         <Note>
-          Free keys (`nawa_test_sk_xxx`) require no credit card. Limited to 100 lifetime requests and 14-day expiry. They use real AI models  -  same accuracy as paid keys.
+          Free keys (`nawa_test_sk_xxx`) require no credit card. Limited to 100 lifetime requests per account (shared across all your free keys) and 14-day expiry. They use real AI models  -  same accuracy as paid keys.
         </Note>
       </Step>
@@ Expand Down @@