Skip to main content

Overview

OathNet uses daily quotas to manage API usage. Each plan has a set number of lookups available per day.

Quota Reset

Your daily quota resets 24 hours after your first lookup of the day. This is a rolling window, not a fixed time. For example:
  • If your first lookup is at 2:00 PM, your quota resets the next day at 2:00 PM
  • The exact reset time is shown in the response metadata

Checking Your Quota

Envelope search responses expose lookup usage in _meta.lookups:
Not every successful endpoint includes quota metadata. Search endpoints do; raw job endpoints and file-stream endpoints may not.

Optimizing Quota Usage

Use Search Sessions

Search sessions let you perform multiple searches for the same query while only consuming one lookup:
See Search Sessions for more details.

Failed Requests Don’t Count

Failed requests (4xx/5xx errors) do not count against your quota. You’re only charged for successful lookups.

Plan Quotas

Each plan has different quota limits. View current plans and quotas at:

View Pricing

See quota limits for each plan

Handling Quota Exhaustion

When your quota is exhausted, you’ll receive a 429 response:
Options when this happens:
  • Wait for your quota to reset (24 hours from first lookup)
  • Upgrade your plan for more lookups

Best Practices

Track _meta.lookups.left_today on envelope search responses to avoid unexpected quota exhaustion:
For repeated searches on the same query, always use search sessions to minimize quota usage.
Cache API responses locally to avoid redundant lookups:

Questions?

Contact support@oathnet.org if you have questions about quotas or need a custom plan.