HTTP history

You can use the HTTP history to see a record of the HTTP traffic that has passed through Burp Proxy. You can also see any modifications that you made to intercepted messages.

The HTTP history contains the following information:

The HTTP history is always updated, even if Intercept is off. This enables you to browse without interruption while you monitor key details about application traffic.

Right-click any item in the table to access further options, such as sending requests to other Burp tools.

Changing the HTTP history layout

You can customize the HTTP history table in the following ways:

Viewing a request

If you select an item from the HTTP history, the lower pane shows the request and response messages for the item. Any modified messages are shown separately. The message may have been modified through:

In addition to the main history view, you can also:

Adding a custom column

You can create your own custom columns using Bambdas.

Custom columns enable you to see more detail about the items in your HTTP history for a more focused analysis of what's important to you.

Two objects of the Montoya API are available to help you write these Bambdas:

To create a custom column for your HTTP history table:

  1. In Proxy > HTTP history, click the options menu > Add custom column. The Add custom column window opens.

  2. Enter a name for your custom column in the Column header field.

  3. Write a Bambda to specify the data that the custom column displays.

  4. Click Apply. This runs the Bambda and outputs any console output or compilation errors into the console. You must resolve any compilation errors before Burp can apply your Bambda.

  5. Click Apply & close.

Example Bambda

In the example below, we'll write a Bambda to create a custom column containing the Server header value of the response.

if (!requestResponse.hasResponse()) { return ""; } var response = requestResponse.response(); return response.hasHeader("Server") ? response.headerValue("Server") : "";

Related pages