Skip to content

The Open Source DocuSign Alternative.

docs: api rate limit (#1899)

Ephraim Duncan939bbcdb3353
diff --git a/apps/documentation/pages/developers/public-api/_meta.json b/apps/documentation/pages/developers/public-api/_meta.json
index 025d862a5..04132f894 100644
--- a/apps/documentation/pages/developers/public-api/_meta.json
+++ b/apps/documentation/pages/developers/public-api/_meta.json
@@ -1,5 +1,6 @@
{
"index": "Get Started",
"authentication": "Authentication",
+ "rate-limits": "Rate Limits",
"versioning": "Versioning"
}
diff --git a/apps/documentation/pages/developers/public-api/rate-limits.mdx b/apps/documentation/pages/developers/public-api/rate-limits.mdx
new file mode 100644
index 000000000..1941258cd
--- /dev/null
+++ b/apps/documentation/pages/developers/public-api/rate-limits.mdx
@@ -0,0 +1,54 @@
+import { Callout } from 'nextra/components';
+
+# Rate Limits
+
+Documenso enforces rate limits on all API endpoints to ensure service stability.
+
+## HTTP Rate Limits
+
+**Limit:** 100 requests per minute per IP address
+**Response:** 429 Too Many Requests
+
+### Rate Limit Response
+
+```json
+{
+ "error": "Too many requests, please try again later."
+}
+```
+
+<Callout type="warning">
+ No rate limit headers are currently provided. When you receive a 429 response, wait at least 60
+ seconds before retrying.
+</Callout>
+
+## Resource Limits
+
+Beyond HTTP rate limits, your account has usage limits based on your subscription plan.
+
+### Plan Limits
+
+| Resource | Free | Paid | Self-hosted | Enterprise |
+| ---------------- | ---- | --------- | ----------- | ---------- |
+| Documents/month | 5 | Unlimited | Unlimited | Unlimited |
+| Total Recipients | 10 | Unlimited | Unlimited | Unlimited |
+| Direct Templates | 3 | Unlimited | Unlimited | Unlimited |
+
+### Error Response
+
+When you exceed a resource limit:
+
+```json
+{
+ "error": "You have reached your document limit for this month. Please upgrade your plan.",
+ "code": "LIMIT_EXCEEDED",
+ "statusCode": 400
+}
+```
+
+## Error Codes
+
+| Code | Status | Description |
+| ------------------- | ------ | ----------------------------- |
+| `TOO_MANY_REQUESTS` | 429 | HTTP rate limit exceeded |
+| `LIMIT_EXCEEDED` | 400 | Resource usage limit exceeded |