Skip to main content
GETActive

GET retrieves a representation of the specified resource. It is safe (read-only), idempotent (same result every call), and cacheable. GET requests must not have side effects – they cannot create, update, or delete resources.

Properties

SafeYesSafe methods don't change server state. They are read-only.
IdempotentYesIdempotent methods produce the same result if called once or multiple times.
CacheableYesCacheable responses may be stored and reused for equivalent requests.
Request BodyNoWhether a request body is allowed / expected.
Response BodyYesWhether a response body is expected.

Description

The GET method requests a representation of the specified resource. Requests using GET should only retrieve data and should have no other effect. GET is the most common HTTP method – used for all web page loads, API data fetches, and asset requests.

Examples

Fetch a user
http
GET /api/users/42 HTTP/1.1
Host: api.example.com
Accept: application/json
Authorization: Bearer <token>
List resources
http
GET /api/articles?page=1&limit=20&sort=created_at HTTP/1.1
Host: api.example.com
Accept: application/json

Specification

RFC 9110GET method specification →