Skip to main content


Laurence MorganLess than 1 minute


Makes a standard HTTP request and returns the result as a JSON object


Fetches a page from a URL via HTTP/S GET request


get url -> <stdout>

<stdin> -> get url -> <stdout>


» get -> [ Status ]
    "Code": 200,
    "Message": "OK"


JSON return

get returns a JSON object with the following fields:

    "Status": {
        "Code": integer,
        "Message": string,
    "Headers": {
        string [
    "Body": string

The concept behind this is it provides and easier path for scripting eg pulling
specific fields via the index, `[`, function.

### `get` as a method

Running `get` as a method will transmit the contents of STDIN as part of the
body of the HTTP GET request. When run as a method you have to include a second
parameter specifying the Content-Type MIME.

### Configurable options

`get` 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" get:

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

* [`[ Index ]`](../parser/
  Outputs an element from an array, map or table
* [`[[ Element ]]`](../parser/
  Outputs an element from a nested structure
* [`config`](../commands/
  Query or define Murex runtime settings
* [`getfile`](../commands/
  Makes a standard HTTP request and return the contents as Murex-aware data type for passing along Murex pipelines.
* [`post`](../commands/
  HTTP POST request with a JSON-parsable return


This document was generated from [builtins/core/httpclient/get_doc.yaml](
Last update:
Contributors: Laurence Morgan,Laurence Morgan,Laurence