> ## 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

Return a list of requests with optional filtering.

<Note>
  External Documentation

  To learn more, visit the [Admin By Request documentation](https://www.adminbyrequest.com/en/docs/requests-api).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter            | Description                                                                              |
  | -------------------- | ---------------------------------------------------------------------------------------- |
  | Approved By          | Filter results by the email address of the portal user who approved the request.         |
  | Denied By            | Filter results by the email address of the portal user who denied the request.           |
  | Include Scan Details | Whether to include scan details in the results.                                          |
  | Last                 | The number of entries to retrieve from the end of the list. The maximum value is `1000`. |
  | Limit                | TThe maximum number of resources to return. The maximum value is `1000`.                 |
  | Start ID             | The resource ID as a pagination token that indicates the next results page.              |
  | Status               | Filter requests by their status.                                                         |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter | Description                                                |
  | --------- | ---------------------------------------------------------- |
  | Reason    | Filter results by the reason of the denial of the request. |
</div>

## Example Output

```json theme={"dark"}
[
	{
		"id": 615669,
		"traceNo": "34376579",
		"settingsName": "Global",
		"type": "Run As Admin",
		"typeCode": 0,
		"status": "Pending approval",
		"statusCode": 4,
		"reason": "Need to update reader. It says out of date when trying to open PDF files from our supplier.",
		"approvedBy": null,
		"deniedReason": null,
		"deniedBy": null,
		"requestTime": "2020-04-01T12:03:00",
		"auditLogLink": "https://www.adminbyrequest.com/AuditLog?Page=AppElevations&ID=34376579&ShowFilter=false",
		"user": {
			"account": "ACME\\PDH",
			"fullName": "Paul David Hewson",
			"email": "pdh@acme.com",
			"phone": "555.345.6789"
		},
		"computer": {
			"name": "W1005623",
			"platform": "Windows",
			"platformCode": 0,
			"make": "Dell Inc.",
			"model": "XPS 15 9550"
		},
		"application": {
			"file": "readerdc_uk_fb_crd_install.exe",
			"name": "Adobe Download Manager",
			"vendor": "Adobe Inc.",
			"version": "2.0.0.495s",
			"sha256": "9369FB712545F6B6FEC5FBF8B1DD228E57CA7899933BBE354B7C4351C8700C99",
			"scanResult": "Clean",
			"scanResultCode": 0,
			"threat": null,
			"virustotalLink": "https://www.virustotal.com/latest-scan/9369FB712545F6B6FEC5FBF8B1DD228E57CA7899933BBE354B7C4351C8700C99",
			"preapproved": false
		},
		"scanResults": [
			{
				"scanResult": "Clean",
				"scanResultCode": 0,
				"engine": "BitDefender",
				"threat": null
			},
			{
				"scanResult": "Clean",
				"scanResultCode": 0,
				"engine": "CrowdStrike",
				"threat": null
			},
			{
				"scanResult": "Clean",
				"scanResultCode": 0,
				"engine": "McAfee",
				"threat": null
			}
		]
	}
]
```

## Workflow Library Example

[List Requests with Admin by Request and Send Results Via Email](https://library.blinkops.com/workflows/list-requests-with-admin-by-request-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-admin-by-request-and-send-results-via-email/canvas" />
</div>