resp_headers()retrieves a list of all headers.resp_header()retrieves a single header.resp_header_exists()checks if a header is present.
Usage
resp_headers(resp, filter = NULL)
resp_header(resp, header, default = NULL)
resp_header_exists(resp, header)Arguments
- resp
A httr2 response object, created by
req_perform().- filter
A regular expression used to filter the header names.
NULL, the default, returns all headers.- header
Header name (case insensitive)
- default
Default value to use if header doesn't exist.
Value
resp_headers()returns a list.resp_header()returns a string if the header exists andNULLotherwise.resp_header_exists()returnsTRUEorFALSE.
Examples
resp <- request("https://httr2.r-lib.org") |> req_perform()
resp |> resp_headers()
#> <httr2_headers>
#> server: GitHub.com
#> content-type: text/html; charset=utf-8
#> last-modified: Mon, 22 Jun 2026 22:14:26 GMT
#> access-control-allow-origin: *
#> etag: W/"6a39b3c2-4b79"
#> expires: Tue, 23 Jun 2026 10:12:12 GMT
#> cache-control: max-age=600
#> content-encoding: gzip
#> x-proxy-cache: MISS
#> x-github-request-id: E5FC:2FEF0E:3FA85A:41E0F1:6A3A59A3
#> accept-ranges: bytes
#> date: Tue, 23 Jun 2026 12:27:54 GMT
#> via: 1.1 varnish
#> age: 18
#> x-served-by: cache-pao-kpao1770072-PAO
#> x-cache: HIT
#> x-cache-hits: 4
#> x-timer: S1782217675.632946,VS0,VE0
#> vary: Accept-Encoding
#> x-fastly-request-id: 89ca9964536590bea2ae2e1fa313038e71b37cc9
#> content-length: 4833
resp |> resp_headers("x-")
#> <httr2_headers>
#> x-proxy-cache: MISS
#> x-github-request-id: E5FC:2FEF0E:3FA85A:41E0F1:6A3A59A3
#> x-served-by: cache-pao-kpao1770072-PAO
#> x-cache: HIT
#> x-cache-hits: 4
#> x-timer: S1782217675.632946,VS0,VE0
#> x-fastly-request-id: 89ca9964536590bea2ae2e1fa313038e71b37cc9
resp |> resp_header_exists("server")
#> [1] TRUE
resp |> resp_header("server")
#> [1] "GitHub.com"
# Headers are case insensitive
resp |> resp_header("SERVER")
#> [1] "GitHub.com"
# Returns NULL if header doesn't exist
resp |> resp_header("this-header-doesnt-exist")
#> NULL