path: root/doc/src/manual/cowboy_req.resp_headers.asciidoc

= cowboy_req:resp_headers(3)

== Name

cowboy_req:resp_headers - Access HTTP headers set for the response

== Description

[source,erlang]
----
resp_headers(Req) -> cowboy:http_headers()

Req :: cowboy_req:req()
----

Return all HTTP response headers.

== Arguments

Req::

The Req object.

== Return value

Headers are returned as a map with keys being lowercase
binary strings, and values as binary strings.
If no response headers have been added the empty map is returned.

== Changelog

* *2.0*: Function introduced.

== Examples

.Get all response headers
[source,erlang]
----
Headers = cowboy_req:resp_headers(Req).
----

== See also

link:man:cowboy_req(3)[cowboy_req(3)],
link:man:cowboy_req:set_resp_headers(3)[cowboy_req:set_resp_headers(3)]