> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Requests

Retrieve HTTP request history for a specified endpoint with optional filtering.

<Note>
  External Documentation

  To learn more, visit the [Beeceptor documentation](https://beeceptor.com/docs/api-for-request-history-extract/#get-all-requests).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter             | Description                                                                                                                        |
  | --------------------- | ---------------------------------------------------------------------------------------------------------------------------------- |
  | Date Range            | The relative timeframe for request retrieval.<br /><br />For example:<br />- '10m' - last 10 minutes<br />- '24h' - last 24 hours. |
  | Endpoint Name         | The name of the endpoint to list requests of.                                                                                      |
  | Method                | Filter requests by HTTP method.                                                                                                    |
  | Path                  | Filter requests by their URL path.                                                                                                 |
  | Response Detail Level | Select `basic` for essential data or `full` for complete request/response details.                                                 |
  | Status                | Filter requests by HTTP response status code (`200`-`599`).                                                                        |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter     | Description                                                                                     |
  | ------------- | ----------------------------------------------------------------------------------------------- |
  | Count         | The number of results to retrieve (up to 500 per request).                                      |
  | From Date     | Retrieve requests that occurred after this timeframe.                                           |
  | Response Body | Filter requests where the response payload contains this value (supports text search or regex). |
  | To Date       | Retrieve requests that occurred before this timeframe.                                          |
</div>

## Example Output

```json theme={"dark"}
{
	"data": [
		{
			"id": "tabejjdc5wg",
			"date": "2023-11-02T12:07:17.350Z",
			"method": "GET",
			"path": "/random-responses",
			"rule": true,
			"status": 505,
			"timeTaken": 37
		},
		{
			"id": "1kjuikmdna3",
			"date": "2023-11-02T12:07:12.263Z",
			"method": "POST",
			"path": "/post-for-templated-response?address=Hyderabad",
			"rule": true,
			"status": 202,
			"timeTaken": 5028
		}
	]
}
```

## Workflow Library Example

[List Requests with Beeceptor and Send Results Via Email](https://library.blinkops.com/workflows/list-requests-with-beeceptor-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-requests-with-beeceptor-and-send-results-via-email/canvas" />
</div>