Skip to main content
Version: Streamsheets 2.5


Create an HTTP HEAD request. The HTTP HEAD method requests HTTP headers from the server as if the document was requested using the HTTP GET method. The only difference between HTTP HEAD and GET requests is that for HTTP HEAD, the server only returns headers without body.


=HTTP.HEAD(URL, [HeadersJSON], [ConfigJSON], [Target])


URLThe URL to request.
HeadersJSON (optional)Headers of the HTTP request.
ConfigJSON (optional)A JSON configuration for the HTTP request. Possible configurations are: "baseURL","timeout","auth: { username: 'secret', password: 'tops3cret' }","proxy: {protocol: 'https',host: '',port: 9000, auth: {username: 'secret', password: 'tops3cret' } "
Target (optional)INBOX(), OUTBOX("MsgID") or a cell range where the result will be placed. Make sure the cell range is big enough or not everything is displayed.


The function HTTP.HEAD() always returns a unique random request ID. Otherwise an error is displayed.



Examples for using the config and header parameter. Use a JSON() function around the cell range.

=HTTP.HEAD("[object Object])
Request to the APIA request has been made and put the response into the inbox. the response will only return header.