---
title: Rate Limits
description: Learn about the rate limits for the Documenso Public API.
---

import { Callout } from 'fumadocs-ui/components/callout';

## Overview

Documenso enforces rate limits on all API endpoints to ensure service stability.

## HTTP Rate Limits

**Limit:** 1000 requests per minute per IP address  
**Response:** 429 Too Many Requests

<Callout type="info">
  This is the global per-IP ceiling. Your organisation may have its own rate limits configured below
  this value, in which case you can be rate-limited before reaching the global limit.
</Callout>

### Rate Limit Response

```json
{
  "error": "Too many requests, please try again later."
}
```

<Callout type="warn">
  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 |

---

## See Also

- [Authentication](/docs/developers/getting-started/authentication) - API authentication guide
- [API Versioning](/docs/developers/api/versioning) - API version management
- [First API Call](/docs/developers/getting-started/first-api-call) - Getting started with the API
- [Organisation Limits](/docs/self-hosting/configuration/organisation-limits) - Admins: set per-organisation resource quotas and rate limits (the HTTP rate limit above is separate and not admin-settable)
