Burp Suite Enterprise Edition is now available in our secure Cloud  –  Learn more

ProfessionalCommunity Edition

Filtering the HTTP history

  • Last updated: June 18, 2024

  • Read time: 2 Minutes

You can filter the HTTP history to make it easier to analyze. This enables you to systematically examine a large Proxy history and understand where different kinds of interesting requests appear.

The filter bar above the list of interactions describes the current display filter. To configure this, click the filter bar to open the HTTP history filter window.

HTTP history filters

The HTTP history filter window has two tabs - Settings mode and Bambda mode.

The filters only control what is displayed. If you hide items, they are not deleted: they reappear if you reset the filter.

Settings mode

Settings mode enables you to filter your HTTP history quickly, using the following settings:

  • Filter by request type - You can show:

    • Only the items that are in-scope.
    • Only items with responses.
    • Only requests with parameters.
  • Filter by MIME type - You can show or hide responses containing various different MIME types, such as HTML, CSS, or images.
  • Filter by status code - You can show or hide responses with various HTTP status codes.
  • Filter by search term - You can:

    • Filter responses that contain a specified search term.
    • Use a literal string or a regular expression.
    • Make your search case-sensitive.
    • Select Negative search, so only items that don't match the search term are shown.
  • Filter by file extension - You can show or hide items based on their file extension.
  • Filter by annotation - This enables you to only show items with notes or highlights.
  • Filter by listener - You can show items received on a specific listener port. This can be useful when testing access controls.

Bambda mode

Bambda mode enables you to write powerful, custom filters for your HTTP history using Java. Learn more about Bambdas.

Adding annotations

You can add notes and highlights to history items. This enables you to describe the purpose of different items, and to flag interesting items for further investigation.

To highlight an HTTP history item:

  1. In the HTTP history tab, select the history item from the list.
  2. Right-click the item and select Highlight.
  3. Select a color from the list.

To add a note:

  1. In the HTTP history tab, select the history item from the list.
  2. Click Notes.
  3. Enter your comment in the Notes panel.

You can also annotate items as they appear in the Intercept tab. These automatically appear in the HTTP history.

Was this article helpful?