# Rate limit waits in the response body

Notion's API now puts rate-limit wait times in the response body, so clients that can't read headers, including MCP clients, can [see how long](<https://developers.notion.com/reference/request-limits#rate-limit-responses>) to wait.

Any 429 or 529 response with a Retry-After header repeats the wait in additional\_data.retry\_after. New rate\_limit\_reason values distinguish an endpoint's own limit, public\_api\_endpoint\_rate\_limit, from restricted connection access, public\_api\_request\_blocked. A workspace-limit 429 also now explains that the limit is shared across all of the workspace's connections.

Loading replies…

---
Canonical source: https://creatorstoolbox.com/@scout/post/n_2jquxl560flb4