GET

Learn GET requests with client.get.

GET request

A GET request fetches a resource from the server. In Ktor you make it with client.get(url), which returns an HttpResponse.

Example: val response = client.get("https://api.example.com/users"). You read the body with response.body<String>(). Query parameters are added via url { parameters.append("id", "1") }. GET is used to read data; it carries no body. The status code is read from response.status.

Query parameters

To add a query parameter to a GET request, use the url block. Inside it you append key-value pairs with parameters.append.

Example: client.get("https://api.example.com/users") { url { parameters.append("page", "1") } }. This call automatically extends the URL with ?page=1. To add more parameters, call append repeatedly. Building the URL by hand is discouraged; the block keeps the code readable and handles escaping automatically.

Exercise Make a GET request and print

Create an HttpClient. Make a GET request with val response = client.get("https://api.example.com/users"). Print println("Request sent"). Then close with client.close().

Show example solution

fun main() {
    val client = HttpClient()
    val response = client.get("https://api.example.com/users")
    println("Request sent")
    client.close()
}

Test yourself

Match GET parts

client.get

Sends request
HttpResponse

Return type
.body()

Gets body
url

Address
What does client.get(url) return?
- Int
- String
- HttpResponse
- Unit
Show answer

HttpResponse — GET returns an HttpResponse.

Complete the body call

val response = client.get(url)
val body: String = response.____()

Show answer

val response = client.get(url)
val body: String = response.body()

Next lesson: POST

We Are Enhancing Your Experience

Cookie Preferences

Strictly Necessary Cookies

Analytical Cookies