<img referrerpolicy="no-referrer-when-downgrade" src="https://static.scarf.sh/a.png?x-pxid=be2d8a11-9712-4c1d-9963-580b2d4fb133" /> <div align="center"> <img src="./media/header_query.png" alt="TanStack Query" /> </div> <br /> <div align="center"> <a href="https://www.npmjs.com/package/@tanstack/query-core" target="_parent"> <img alt="" src="https://img.shields.io/npm/dm/@tanstack/query-core.svg" alt="npm downloads" /> </a> <a href="https://github.com/TanStack/query/stargazers" target="_parent"> <img alt="" src="https://img.shields.io/github/stars/TanStack/query.svg?style=social&label=Star" alt="GitHub stars" /> </a> <a href="https://bundlejs.com/?q=%40tanstack%2Freact-query&config=%7B%22esbuild%22%3A%7B%22external%22%3A%5B%22react%22%2C%22react-dom%22%5D%7D%7D&badge=" target="_parent"> <img alt="" src="https://deno.bundlejs.com/?q=@tanstack/react-query&config={%22esbuild%22:{%22external%22:[%22react%22,%22react-dom%22]}}&badge=detailed" alt="Bundle size" /> </a> </div> <div align="center"> <a href="#badge"> <img src="https://img.shields.io/badge/%20%20%F0%9F%93%A6%F0%9F%9A%80-semantic--release-e10079.svg" alt="semantic-release"> </a> <a href="https://bestofjs.org/projects/tanstack-query"><img src="https://img.shields.io/endpoint?url=https://bestofjs-serverless.now.sh/api/project-badge?fullName=TanStack%2Fquery%26since=daily" alt="Best of JS" /></a> <a href="https://twitter.com/tan_stack"><img src="https://img.shields.io/twitter/follow/tan_stack.svg?style=social" alt="Follow @TanStack"/></a> </div> <div align="center">

Become a Sponsor!

</div>

TanStack Query

An async state management library built to simplify fetching, caching, synchronizing, and updating server state.

• Protocol‑agnostic fetching (REST, GraphQL, promises, etc.)
• Caching, refetching, pagination & infinite scroll
• Mutations, dependent queries & background updates
• Prefetching, cancellation & React Suspense support

<a href="https://tanstack.com/query">Read the docs →</b></a>

Get Involved

• We welcome issues and pull requests!
• Participate in GitHub discussions
• Chat with the community on Discord
• See CONTRIBUTING.md for setup instructions

Partners

<table align="center"> <tr> <td> <a href="https://www.coderabbit.ai/?via=tanstack&dub_id=aCcEEdAOqqutX6OS" > <picture> <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/coderabbit-dark-D643Zkrv.svg" /> <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" /> <img src="https://tanstack.com/assets/coderabbit-light-CIzGLYU_.svg" height="40" alt="CodeRabbit" /> </picture> </a> </td> <td> <a href="https://www.cloudflare.com?utm_source=tanstack"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" /> <source media="(prefers-color-scheme: light)" srcset="https://tanstack.com/assets/cloudflare-black-6Ojsn8yh.svg" /> <img src="https://tanstack.com/assets/cloudflare-white-Co-Tyjbl.svg" height="60" alt="Cloudflare" /> </picture> </a> </td> </tr> </table> <div align="center"> <img src="./media/partner_logo.svg" alt="Query & you?" height="65"> <p> We're looking for TanStack Query Partners to join our mission! Partner with us to push the boundaries of TanStack Query and build amazing things together. </p> <a href="mailto:partners@tanstack.com?subject=TanStack Query Partnership"><b>LET'S CHAT</b></a> </div> </div>

Explore the TanStack Ecosystem

• <a href="https://github.com/tanstack/config"><b>TanStack Config</b></a> – Tooling for JS/TS packages
• <a href="https://github.com/tanstack/db"><b>TanStack DB</b></a> – Reactive sync client store
• <a href="https://github.com/tanstack/devtools"><b>TanStack DevTools</b></a> – Unified devtools panel
• <a href="https://github.com/tanstack/form"><b>TanStack Form</b></a> – Type‑safe form state
• <a href="https://github.com/tanstack/pacer"><b>TanStack Pacer</b></a> – Debouncing, throttling, batching <br/>
• <a href="https://github.com/tanstack/query"><b>TanStack Query</b></a> – Async state & caching
• <a href="https://github.com/tanstack/ranger"><b>TanStack Ranger</b></a> – Range & slider primitives
• <a href="https://github.com/tanstack/router"><b>TanStack Router</b></a> – Type‑safe routing, caching & URL state
• <a href="https://github.com/tanstack/router"><b>TanStack Start</b></a> – Full‑stack SSR & streaming
• <a href="https://github.com/tanstack/store"><b>TanStack Store</b></a> – Reactive data store
• <a href="https://github.com/tanstack/table"><b>TanStack Table</b></a> – Headless datagrids
• <a href="https://github.com/tanstack/virtual"><b>TanStack Virtual</b></a> – Virtualized rendering

… and more at <a href="https://tanstack.com"><b>TanStack.com »</b></a>

<!-- Use the force, Luke -->