> ## Documentation Index
> Fetch the complete documentation index at: https://docs.freshtalent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate limits and quotas

> Request buckets, retry headers, and monitoring allocation reported by the API.

## Requests

| Limit             | Default | Scope                            |
| ----------------- | ------- | -------------------------------- |
| Requests / minute | 300     | Client IP as seen by the Gateway |

Need more? Email [support@freshtalent.ai](mailto:support@freshtalent.ai?subject=Higher%20rate%20limits).

The current Gateway uses an IP-based bucket, not a separate bucket per API key. Clients sharing an egress IP can share capacity; proxy routing affects which IP the Gateway sees. Do not assume rotating keys increases capacity.

Responses can include `x-ratelimit-limit`, `x-ratelimit-remaining`, and `x-ratelimit-reset` (seconds until reset). On `429`, honor `retry-after` (seconds). The limiter is not a contractual distributed quota across all service replicas.

## Monitoring allocation

Read the current values from [Get account](/api-reference/account/me), rather than hard-coding plan allowances.

* `quota.watch_slots.used` counts distinct `watching` URLs across your organization's Targets **that are not already people in the index graph**. A person on multiple Targets counts once in this organization total.
* `proposed` (Pending Approval) and `excluded` (Removed) members do not count. Not every accepted person consumes allocation.
* `included` is the plan baseline: 0 for free/Index and 1,000 for Unlimited. `max` reflects the configured organization allocation, with a current fallback of 1,000; it is not necessarily equal to `included`.
* `remaining` is `max(0, max - used)`. These reported values are not a reservation for a future request. Follow the specific operation's response.
* `daily_uniques` reports a limit of 100 for free/Index and `null` for Unlimited. Its `remaining` is currently `null` and `enforced` is `false`; the Gateway does not enforce this daily cap.

Check usage in the dashboard or through [GET /me](/api-reference/account/me).

```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "data": {
    "quota": {
      "daily_uniques": { "limit": 100, "remaining": null, "enforced": false },
      "watch_slots": { "included": 1000, "used": 234, "max": 1000, "remaining": 766 }
    }
  }
}
```

## Hitting 429

Over the request cap returns `429`. Back off and retry. See [Errors](/errors).