> ## Documentation Index
> Fetch the complete documentation index at: https://docs.opennote.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Tiers and Limits
> Learn about the tiers and limits of the Opennote API
# API Tiers & Rate Limits
Our API offers three usage tiers designed to scale with your application needs. Each tier provides different rate limits and features to support everything from development and testing to enterprise-scale (and on-premises) production deployments.
## Pricing Tiers
* Ideal for prototyping and small applications
* Simple rate limits to get you started
* Community Discord Support
* \$5 in credits added to your account
* Higher rate limits across all endpoints
* Production-ready performance
* Dedicated Slack Support
* Custom rate limit discussions
* Everything in the Scale tier, and...
* Dedicated on-premises deployment
* Custom integration assistance
* SLA guarantees
All users start on the **Developer** tier automatically. To upgrade your tier, please contact us at [devtools@opennote.me](mailto:devtools@opennote.me) with the subject line "**API Tier Upgrade**".
## Default Rate Limits
Our rate limits are applied per organization and reset at the specified intervals. The limits below are the default values for each tier:
### Developer Tier
| Endpoint | Limit | Description |
| -------------------------------------- | ----------- | ------------------------ |
| `GET /journals/list` | 25 requests | List user's journals |
| `GET /journals/content/{id}` | 10 requests | Get journal content |
| `POST /video/create` | 3 requests | Create new videos |
| `POST /interactives/flashcards/create` | 5 requests | Generate flashcard sets |
| `POST /interactives/practice/create` | 3 requests | Create practice problems |
| `POST /interactives/practice/grade` | 2 requests | Grade practice responses |
| Endpoint | Limit | Description |
| -------------------------------------- | ------------ | -------------------------- |
| `POST /video/create` | 50 requests | Daily video creation limit |
| `POST /interactives/flashcards/create` | 100 requests | Daily flashcard generation |
### Scale Tier
| Endpoint | Limit | Description |
| -------------------------------------- | ------------ | ------------------------ |
| `GET /journals/list` | 100 requests | List user's journals |
| `GET /journals/content/{id}` | 100 requests | Get journal content |
| `POST /video/create` | 10 requests | Create new videos |
| `POST /interactives/flashcards/create` | 50 requests | Generate flashcard sets |
| `POST /interactives/practice/create` | 10 requests | Create practice problems |
| `POST /interactives/practice/grade` | 10 requests | Grade practice responses |
| Endpoint | Limit | Description |
| -------------------------------------- | -------------- | -------------------------- |
| `POST /video/create` | 1,000 requests | Daily video creation limit |
| `POST /interactives/flashcards/create` | 2,000 requests | Daily flashcard generation |
### Enterprise Tier
| Endpoint | Limit | Description |
| -------------------------------------- | --------------- | --------------------------- |
| `GET /journals/list` | 10,000 requests | List user's journals |
| `GET /journals/content/{id}` | 1,000 requests | Get journal content |
| `POST /video/create` | 100 requests | Create new videos |
| `POST /interactives/flashcards/create` | 500 requests | Generate flashcard sets |
| *Practice endpoints* | *Custom limits* | Contact us for requirements |
| Endpoint | Limit | Description |
| -------------------------------------- | --------------- | -------------------------- |
| `POST /video/create` | 10,000 requests | Daily video creation limit |
| `POST /interactives/flashcards/create` | 20,000 requests | Daily flashcard generation |
### Handling Rate Limit Errors
When you exceed a rate limit, the API returns a `429 Too Many Requests` response:
```json theme={null}
{
"error": "Rate limit exceeded for journal_list",
"retry_after": 30,
"limit_type": "minute"
}
```
**Best Practices:**
* Implement exponential backoff when you receive 429 responses
* Monitor the `Retry-After` header on rate limited operations to pace your requests
* This is the best way to make sure that you don't continue pinging endpoints that are throwing errors.
* Cache responses when possible to reduce API calls
* Use webhooks instead of polling for status updates for videos and problems.
## Credits & Pricing
The Opennote API uses a **direct monetary value pricing model**. Different endpoints consume different amounts of money based on their computational complexity.
Our pricing is flexible, and varies request-to-request. More detailed per-input and per-output pricing information is *coming soon*, and can be requested by contacting us at [devtools@opennote.me](mailto:devtools@opennote.me).
### Managing Your Credits
* **View Balance**: Check your current credit balance in the [API Dashboard](https://opennote.com/api/teams)
* **Usage Tracking**: Monitor credit consumption per endpoint in real-time
*Auto-renewal and alerts are coming soon.*
When you need more credits, you can visit your [API Dashboard](https://opennote.com/api/teams) and head to your **Settings -> Billing** tab, and click the **Add Credits** button.
## Custom Rate Limits
Need higher limits for your application? We offer **custom rate limit configurations** for all tiers, which you can request by contacting us at [devtools@opennote.me](mailto:devtools@opennote.me) with the subject line "**API Rate Limit Increase**".
## Need Help?
* **Technical Support**: [devtools@opennote.me](mailto:devtools@opennote.me)
* **Tier Upgrades**: Include "API Tier Upgrade" in your subject line
* **Custom Limits**: Include "API Rate Limit Increase" in your subject line
* **Billing Questions**: Include "API Billing" in your subject line
We typically respond to all inquiries within 24 hours.