when building web APIs, choosing the correct HTTP method is an important part of API design. For many years, developers have mainly used GET to retrieve data and POST to send data to the server.
These methods work well for most applications, but they also have limitations. Modern applications often need to perform complex searches with multiple filters, sorting options, and advanced conditions. In these situations, developers usually have to choose between using a long GET URL or using POST for a read-only operation.
To solve this problem, the Internet Engineering Task Force (IETF) introduced a new HTTP method called QUERY in RFC 10008, published in June 2026. It's the first new HTTP method to become an official standard in more than two decades.
In this article, we'll explore what the HTTP QUERY method is, why it was introduced, and how it can improve API design.
The Challenge with GET Requests
GET is the standard HTTP method used for retrieving information from a server.
For example, a user searching for action movies released in 2025 can send a simple GET request:
GET /movies?genre=Action&year=2025
This approach works well because the request is short and easy to understand.
However, modern applications often require more advanced search options. Imagine a user wants to find movies with these conditions:
- Genre: Action or Adventure
- Language: English
- Rating above 8
- Released after 2020
- Available for streaming
- Sorted by rating
Representing all these conditions in a URL can make the request very long and difficult to manage. A complexGETrequest may look like this:
GET /movies?genre=Action&genre=Adventure&language=English&rating=8&year=2020&streaming=true&sort=rating
As the number of filters increases, URLs become harder to read, maintain, and process.
Why Developers Use POST for Searching
To avoid long URLs, developers often use POST requests for complex searches.
POST /movies/search
Content-Type: application/json
{
"genres": ["Action", "Adventure"],
"language": "English",
"minRating": 8,
"releasedAfter": 2020,
"streaming": true,
"sortBy": "rating"
}
This approach is cleaner because the search criteria are sent inside the request body.
However, POST is mainly designed for operations that create or modify resources, such as:
- Creating a new account
- Uploading files
- Updating information
Although a search request usingPOSTdoes not modify data, the HTTP method itself does not clearly communicate that it is a read-only operation.
POST and QUERY Can Look the Same — So What's the Real Difference?
Here is where many readers get confused: a POST request and a QUERY request can have the exact same body. Look at these two requests:
POST /movies/search
Content-Type: application/json
{
"genres": ["Action", "Adventure"]
}
QUERY /movies
Content-Type: application/json
{
"genres": ["Action", "Adventure"]
}
The JSON inside is exactly the same. So if you only look at the body, you can't tell these two requests apart. Then why do we need two different methods?
Because the body is not what carries the meaning. The method name carries the meaning. The body just holds the data. The method tells the server what to do with that data.
Think of the method name as a label on a box, not what's inside the box:
POST means: "Do something with this — it might create, change, or update something. Don't repeat this request automatically, since repeating it could cause problems."QUERY means: "Just read this and send back an answer. Nothing will change. It's safe to repeat, and safe to save (cache) the response."
This label matters, even when the data is the same, because other tools read the method name and act on it — without ever looking inside the body:Caches and CDNs don't save (cache)
POSTresponses, sincePOSTmight change something. But they can safely save aQUERYresponse, sinceQUERYpromises not to change anything.Browsers won't automatically resend a failed
POSTrequest, because resending it could do something twice (like creating two accounts by mistake). A failedQUERYcan be resent safely, since it never changes data.Other developers reading your API can understand what an endpoint does just from its method name.
POST /movies/searchdoesn't tell you if it's a search or a change — you'd have to check the code.QUERY /moviestells you right away: this only reads data.
So the identical body is not a problem — it's actually the reasonQUERYneeded to exist. IfPOSTandQUERYcould never look the same, there would be no confusion, and no need for a new method.QUERYexists to remove that confusion, so a read-only request no longer has to borrowPOSTjust to send a body.
Introducing the HTTP QUERY Method
The HTTP QUERY method was introduced to fill this gap. QUERY combines the advantages of GET and POST:
- Like
POST, it supports a request body. - Like
GET, it represents a safe, read-only operation — and it's cacheable, so proxies and CDNs can cache aQUERYresponse the same way they'd cache aGET.
The previous movie search can be written usingQUERY:
QUERY /movies
Content-Type: application/json
{
"genres": ["Action", "Adventure"],
"language": "English",
"minRating": 8,
"releasedAfter": 2020,
"streaming": true,
"sortBy": "rating"
}
This request clearly communicates its purpose: the client wants to retrieve data based on specific conditions without changing anything on the server.
GET vs POST vs QUERY
| Method | Body support | Safe / read-only | Cacheable | Best for |
|---|---|---|---|---|
GET | No (query params only) | Yes | Yes | Simple retrieval |
POST | Yes | No | No | Creating/updating resources |
QUERY | Yes | Yes | Yes | Complex read-only operations |
Summary:
GETis best for simple data retrieval where query parameters are enough.
POSTis useful when sending large amounts of data or creating/updating resources.
QUERYis designed for complex read-only operations where a request body is required.
## Why Is QUERY Important?
Supports Complex Data Structures
Developers can send structured data such as JSON objects, arrays, and nested filters instead of creating complicated URLs:
{
"filters": {
"rating": 8,
"year": 2025
},
"sort": "rating"
}
This makes complex requests easier to understand and maintain, and gives developers a standard way to handle advanced search requirements without misusing other HTTP methods.
Improves API Clarity
The HTTP method itself describes the purpose of the request. A developer reading:
QUERY /movies
can immediately understand that the operation is intended for retrieving information.
Real-World Use Cases
The QUERY method can be useful in applications that require complex read operations, such as:
- Movie and streaming platforms
- Online shopping applications
- Travel booking systems
- Library management systems
- Employee management systems
- Analytics dashboards and reporting applications
For example, an analytics dashboard may need to retrieve data based on multiple date ranges, different user groups, several filtering conditions, and custom sorting rules. A QUERY request can represent all of this clearly in a single, structured body.
Conclusion
The HTTP QUERY method provides a standard way to perform complex read-only operations using a request body. It combines the flexibility of POST with the safe semantics of GET, making APIs clearer and more expressive. Although adoption will take time, QUERY is a valuable addition to modern API design.
SOCIAL SHARE CARD GENERATOR