---
title: Requests
summary: Requests lists individual requests that have been tagged with signals.
url: https://www.fastly.com/documentation/reference/api/security/requests
---

Requests lists individual requests that have been tagged with signals.

## Data model

| Field | Type | Description |
|-------|------|-------------|
| `agent_response_code` | integer | Agent response code. (Read-only) |
| `country` | string | Country code. (Read-only) |
| `id` | string | A base62-encoded representation of a UUID used to uniquely identify a request. (Read-only) |
| `method` | string | HTTP method. (Read-only) |
| `path` | string | Request path. (Read-only) |
| `protocol` | string | HTTP protocol. (Read-only) |
| `remote_hostname` | string | Remote hostname. (Read-only) |
| `remote_ip` | string | Remote IP address. (Read-only) |
| `request_headers` | array | Request headers. (Read-only) |
| `response_code` | integer | HTTP response code. (Read-only) |
| `response_headers` | array | Response headers. (Read-only) |
| `response_size` | integer | HTTP response size. (Read-only) |
| `response_time` | integer | Response time in milliseconds. (Read-only) |
| `scheme` | string | Request scheme. (Read-only) |
| `server_hostname` | string | Server hostname. (Read-only) |
| `server_name` | string | Server name. (Read-only) |
| `signals` | array | List of signals. (Read-only) |
| `timestamp` | string | Time when the request was made. |
| `tls_cipher` | string | TLS cipher. (Read-only) |
| `tls_protocol` | string | TLS protocol. (Read-only) |
| `uri` | string | Request URI. (Read-only) |
| `user_agent` | string | User agent. (Read-only) |
| `name` | string | Header name. |
| `value` | string | Header value. |
| `detector` | string | Detector that detected the signal. (Read-only) |
| `location` | string | Where the signal was detected. (Read-only) |

## API endpoints

### Search requests

**GET** `/security/workspaces/{workspace_id}/requests`

Find requests in a workspace.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `limit` | integer | query | No | Limit how many results are returned. |
| `page` | integer | query | No | Page number of the collection to request. |
| `q` | string | query | No | Search query. See Search Syntax: <a href="https://www.fastly.com/documentation/guides/next-gen-waf/reference/searching-for-requests/">https://www.fastly.com/documentation/guides/next-gen-waf/reference/searching-for-requests/</a>. |
| `workspace_id` | string | path | Yes | The ID of the workspace. |

### Retrieve request

**GET** `/security/workspaces/{workspace_id}/requests/{request_id}`

Get a request in a workspace.

**Parameters:**

| Name | Type | In | Required | Description |
|------|------|----|---------|--------------|
| `request_id` | string | path | Yes | The ID of the request. |
| `workspace_id` | string | path | Yes | The ID of the workspace. |