Skip to main content


Laurence MorganLess than 1 minute


Makes a standard HTTP request and return the contents as Murex-aware data type for passing along Murex pipelines.


Fetches a resource from a URL - setting STDOUT data-type


getfile url -> <stdout>




This simply fetches a resource (via HTTP GET request) from a URL and returns the byte stream to STDOUT. It will set STDOUT's data-type based on MIME defined in the Content-Type HTTP header.

It is recommended that you only use this command if you're pipelining the output (eg writing to file or passing on to another function). If you just want to render the output to the terminal then use open which has hooks for smart terminal rendering.

Configurable options

getfile has a number of behavioral options which can be configured via Murex's standard config tool:

config -> [ http ]

To change a default, for example the user agent string:

config set http user-agent "bob"

This enables sane, repeatable and readable defaults. Read the documents on config for more details about it's usage and the rational behind the command.

See Also

  • config: Query or define Murex runtime settings
  • get: Makes a standard HTTP request and returns the result as a JSON object
  • open: Open a file with a preferred handler
  • post: HTTP POST request with a JSON-parsable return

This document was generated from builtins/core/httpclient/get_doc.yamlopen in new window.

Last update:
Contributors: Laurence Morgan,Laurence Morgan,Laurence