PingCAP · Rate Limits

Tidb Rate Limits

TiDB Cloud throttles on two independent axes. The CONTROL PLANE (the REST management APIs) is capped at 100 requests per minute per API key and returns 429 with X-Ratelimit-* headers. The DATA PLANE is metered in Request Units and storage rather than HTTP requests — Starter allots 250M RUs/month and 25 GiB row + 25 GiB column storage per organization, the Essential preview autoscales up to 100K RUs, and Premium and Dedicated scale further.

Tidb Rate Limits is the machine-readable rate-limit profile for PingCAP on the APIs.io network, conforming to the API Commons Rate Limits specification.

It captures 6 rate-limit definitions, measuring requests, request_units_per_month, gb, and request_units_per_second.

The profile also includes 3 backoff/retry policies defined and response codes documented for throttled.

Tagged areas include Database, Cloud, and Rate Limiting.

6 Limits Throttle: 429
DatabaseCloudRate Limiting

Limits

TiDB Cloud API requests api_key
requests · minute
100
Per API key, not per organization or per endpoint. 107 of the 162 published operations declare a 429 response.
Chat2Query Data App requests data_app
requests · day
100
The Chat2Query Data App is rate limited to 100 requests per day per Data App — two orders of magnitude tighter than the management API, and the binding constraint for any agent using it.
Starter Free Request Units organization
request_units_per_month · month
250000000
Free monthly RU allowance per organization on the Starter tier.
Starter Free Row Storage organization
gb · month
25
25 GiB of row storage included free per organization on Starter.
Starter Free Column Storage organization
gb · month
25
25 GiB of column storage included free per organization on Starter.
Essential Autoscale Ceiling cluster
request_units_per_second · second
100000
Essential preview autoscales up to 100K RUs per second.

Policies

Request Units (RUs)
TiDB Cloud meters work in Request Units, not raw HTTP requests; an RU encapsulates the compute and IO of a query and is the primary unit for both throttling and billing.
Spend Limits
Starter exposes spend limits and scale-to-zero so customers can bound monthly cost while remaining pay-as-you-go beyond the free allowance.
Autoscaling
Essential and Premium scale RU capacity automatically; Premium has unlimited autoscaling while Essential caps at ~100K RUs.

Sources

Work with this as data

Every rate limit here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for rate limits

4 MCP tools reach this
  • find_rate_limitsBrowse and filter every rate limit in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This rate limit 
curl "https://apis.io/api/v1/rate-limits/tidb-rate-limits"
All rate limits 
curl "https://apis.io/api/v1/rate-limits?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.