# Usage Limits and Quotas

## [Usage Limits and Quotas](https://app.tomba.io/usage)

Use the [**Usage Dashboard**](https://app.tomba.io/usage) to monitor and manage your API usage. It provides a clear summary of:

- API call volume
- Remaining quota
- Personal vs. team usage
- Historical trends (up to 3 months)

---

## Viewing Your Usage

- **Individual and Team Views:** Choose to display only your own API requests or view the cumulative usage of your team via the [Usage Panel](https://app.tomba.io/usage).
- **Flexible Insights:** Switch between daily, weekly, and monthly data to track your activity and adjust your strategy accordingly.

If you want to monitor usage during API calls, inspect rate-limit headers directly:

```bash
curl -i -X GET "https://api.tomba.io/v1/domain-search?domain=example.com" \
  -H "X-Tomba-Key: your_api_key" \
  -H "X-Tomba-Secret: your_secret_key"
```

Check `X-RateLimit-Limit`, `X-RateLimit-Remaining`, and `X-RateLimit-Reset` in the response headers.

---

## [Request History](https://app.tomba.io/usage/requests)

For advanced tracking and auditing:

- **Detailed Logs:** View up to **1,000 recent requests** made in the past 90 days in the [Request History](https://app.tomba.io/usage/requests) section.
- **CSV Export:** Download your request log as a CSV file for further analysis, performance review, or compliance tracking.

---

## Smart Request Handling

- **No Charge for Empty Results:**  
  When a **[Domain Search](https://tomba.io/domain-search)**, **[Email Finder](https://tomba.io/email-finder)**, or **[Email Verifier](https://tomba.io/email-verifier)** request doesn’t return a result, it **will not count** against your quota.

  > For example: Verifying a webmail like `gmail.com` will return no result and consume **zero requests**.

- **Requests Counted Once Every 30 Days:**  
  Identical API requests are **only counted once every 30 days**.
  > This is especially useful when re-running the same data due to temporary storage issues or testing your integration.

---

## Monthly Reset and Carryover Policy

- **Monthly Reset:** Your quota resets automatically every 30 days based on your [subscription cycle](https://app.tomba.io/settings/subscription).
- **No Carryover:** **Unused requests do not roll over** to the next month. Be sure to make full use of your credits within the cycle.

---

By understanding your usage patterns and these rules, you can optimize workflows, avoid unnecessary consumption, and fully use your monthly plan with [Tomba.io](https://tomba.io).
