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

Developer

• Ideal for prototyping and small applications
• Simple rate limits to get you started
• Community Discord Support
• $5 in credits added to your account

Scale

• Higher rate limits across all endpoints
• Production-ready performance
• Dedicated Slack Support
• Custom rate limit discussions

Enterprise

• 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 [e-mail] 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

Per Minute Limits

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

Per Day Limits

Endpoint	Limit	Description
POST /video/create	50 requests	Daily video creation limit
POST /interactives/flashcards/create	100 requests	Daily flashcard generation

Scale Tier

Per Minute Limits

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

Per Day Limits

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

Per Minute Limits

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

Per Day Limits

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:

{
  "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 [e-mail].

Managing Your Credits

• View Balance: Check your current credit balance in the API Dashboard
• 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 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 [e-mail] with the subject line “API Rate Limit Increase”.

Need Help?

• Technical Support: [e-mail]
• 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.