The Open Source DocuSign Alternative.
TypeScript digital-signaturedocument-signingdocusign-alternativee-signatureesignesignaturenext-authnextjsopen-sourcepades-standardpdfpdf-signpdf-signaturepostgresqlprismaself-hostedsigningtypescript
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.jsonindex 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.mdxnew file mode 100644index 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 |