# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.nightfall.ai/developer-api/nightfall_apis/saas/rate-limits-for-native-saas-app-apis.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.