## List Requests

`cloudforce_one.requests.list(RequestListParams**kwargs)  -> SyncSinglePage[ListItem]`

**post** `/accounts/{account_id}/cloudforce-one/requests`

List Requests

### Parameters

- `account_id: str`

  Identifier.

- `page: int`

  Page number of results.

- `per_page: int`

  Number of results per page.

- `completed_after: Optional[Union[str, datetime]]`

  Retrieve requests completed after this time.

- `completed_before: Optional[Union[str, datetime]]`

  Retrieve requests completed before this time.

- `created_after: Optional[Union[str, datetime]]`

  Retrieve requests created after this time.

- `created_before: Optional[Union[str, datetime]]`

  Retrieve requests created before this time.

- `request_type: Optional[str]`

  Requested information from request.

- `sort_by: Optional[str]`

  Field to sort results by.

- `sort_order: Optional[Literal["asc", "desc"]]`

  Sort order (asc or desc).

  - `"asc"`

  - `"desc"`

- `status: Optional[Literal["open", "accepted", "reported", 3 more]]`

  Request Status.

  - `"open"`

  - `"accepted"`

  - `"reported"`

  - `"approved"`

  - `"completed"`

  - `"declined"`

### Returns

- `class ListItem: …`

  - `id: str`

    UUID.

  - `created: datetime`

    Request creation time.

  - `priority: Literal["routine", "high", "urgent"]`

    - `"routine"`

    - `"high"`

    - `"urgent"`

  - `request: str`

    Requested information from request.

  - `summary: str`

    Brief description of the request.

  - `tlp: Literal["clear", "amber", "amber-strict", 2 more]`

    The CISA defined Traffic Light Protocol (TLP).

    - `"clear"`

    - `"amber"`

    - `"amber-strict"`

    - `"green"`

    - `"red"`

  - `updated: datetime`

    Request last updated time.

  - `completed: Optional[datetime]`

    Request completion time.

  - `message_tokens: Optional[int]`

    Tokens for the request messages.

  - `readable_id: Optional[str]`

    Readable Request ID.

  - `status: Optional[Literal["open", "accepted", "reported", 3 more]]`

    Request Status.

    - `"open"`

    - `"accepted"`

    - `"reported"`

    - `"approved"`

    - `"completed"`

    - `"declined"`

  - `tokens: Optional[int]`

    Tokens for the request.

### Example

```python
import os
from cloudflare import Cloudflare

client = Cloudflare(
    api_email=os.environ.get("CLOUDFLARE_EMAIL"),  # This is the default and can be omitted
    api_key=os.environ.get("CLOUDFLARE_API_KEY"),  # This is the default and can be omitted
)
page = client.cloudforce_one.requests.list(
    account_id="023e105f4ecef8ad9ca31a8372d0c353",
    page=0,
    per_page=10,
)
page = page.result[0]
print(page.id)
```

#### Response

```json
{
  "errors": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "messages": [
    {
      "code": 1000,
      "message": "message",
      "documentation_url": "documentation_url",
      "source": {
        "pointer": "pointer"
      }
    }
  ],
  "success": true,
  "result": [
    {
      "id": "f174e90a-fafe-4643-bbbc-4a0ed4fc8415",
      "created": "2022-04-01T00:00:00Z",
      "priority": "routine",
      "request": "Victomology",
      "summary": "DoS attack",
      "tlp": "clear",
      "updated": "2022-04-01T00:00:00Z",
      "completed": "2024-01-01T00:00:00Z",
      "message_tokens": 16,
      "readable_id": "RFI-2022-000001",
      "status": "open",
      "tokens": 0
    }
  ]
}
```