# Rate Limits for Native SaaS app APIs

To prevent misuse and ensure the stability of our platform, we enforce a rate limit on an API Key and endpoint basis, similar to the way many other APIs enforce rate limits.

When operating under our **Free plan**, accounts and their corresponding API Keys have a rate limit of 5 requests per second on average, with support for bursts of 15 requests per second. If you upgrade to a paid plan – the **Enterprise plan** – this rate increases to a limit of 10 requests per second on average and bursts of 50 requests per second.

| Plan       | Requests Per Second (Avg) | Burst |
| ---------- | ------------------------- | ----- |
| Free       | 5                         | 15    |
| Enterprise | 10                        | 50    |

The Nightfall API follows standard practices and conventions to signal when these rate limits have been exceeded.

Successful requests return a header `X-Rate-Limit-Remaining` with the integer number of requests remaining before errors will be returned to the client.

When your application exceeds the rate limit for a given API endpoint, the Nightfall API will return an HTTP [response code of 429](https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/429) "Too Many Requests.” If your use case requires increased rate limiting, please reach out to <support@nightfall.ai.>

Additionally, these unsuccessful requests return the number of seconds to wait before retrying the request in a [Retry-After](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Retry-After) Header.

## Request Rate Limiting

Your Request Rate Limiting throttles how frequently you can make requests to the API. You can monitor your rate limit usage via the \``X-Rate-Limit-Remaining`\` header, which tells you how many remaining requests you can make within the next second before being throttled.

## Quotas

Your Quota limits how many requests you can make within a given period. Your current remaining quota and the end of your current quota period are denoted by the following response headers.

|   Response Headers   |   Type   |                                                                    Description                                                                   |
| :------------------: | :------: | :----------------------------------------------------------------------------------------------------------------------------------------------: |
|  `X-Quota-Remaining` |  string  | The requests remaining in your quota for this period. Will be reset to the amount specified in your billing plan at the end of your quota cycle. |
| `X-Quota-Period-End` | datetime |                         The date and time at which your quota will be reset, encoded as a string in the RFS-3339 format.                         |

For the free plan, we allow 5 requests per second and 10000 requests in a day.