---
title: "Query quota and rate limit info"
method: GET
path: "/rate_limit"
---

# Query quota and rate limit info

`GET /rate_limit`

## Request

- Base URL: `https://api.dnsdb.info/dnsdb/v2`
- URL: `https://api.dnsdb.info/dnsdb/v2/rate_limit`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/domaintools/apis/dnsdb/docs/rate_limit/get.ts> (a function with typed inputs; its response is checked against the schema)

For block quotas, there are a number of queries that are bought, with all, or a subset, of that number “split” off for a particular API key; e.g. a split is an allocation from the amount of queries purchased. Block quotas have a specific number of queries split with an expiration time (the expiration time is usually much longer than a day). For each API key, the DNSDB API server tracks the number of queries split, number used, and the expiration time. The number of queries bought is not visible to the DNSDB API server.

## Response `200`

rate limit

## Other responses

- `401`: Invalid or missing API key.
- `403`: Authenticated but not authorized for this resource.
- `429`: Rate limit exceeded.
- `502`: Upstream server error.

---

[API](https://skmtc.dev/domaintools/apis/dnsdb.md) - [All operations](https://skmtc.dev/domaintools/apis/dnsdb/llms.txt) - [OpenAPI document](https://skmtc.dev/domaintools/apis/dnsdb/revisions/1f5e4f955036?raw)