--- title: List Requests --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/python) [Cloudforce One](https://developers.cloudflare.com/api/python/resources/cloudforce_one) [Requests](https://developers.cloudflare.com/api/python/resources/cloudforce_one/subresources/requests) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Requests cloudforce\_one.requests.list(RequestListParams\*\*kwargs) -> SyncSinglePage\[[ListItem]()] POST/accounts/{account\_id}/cloudforce-one/requests Lists Cloudforce One intelligence requests with filtering and pagination. ##### Security API Email + API Key The previous authorization scheme for interacting with the Cloudflare API, used in conjunction with a Global API key. **Example:**`X-Auth-Email: user@example.com` The previous authorization scheme for interacting with the Cloudflare API. When possible, use API tokens instead of Global API keys. **Example:**`X-Auth-Key: 144c9defac04969c7bfad8efaa8ea194` ##### Accepted Permissions (at least one required) `Cloudforce One Write` ##### ParametersExpand Collapse account\_id: str Identifier. maxLength32 [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20account_id%20%3E%20(schema)>) page: int Page number of results. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: int Number of results per page. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20per_page%20%3E%20(schema)>) completed\_after: Optional\[Union\[str, datetime]] Retrieve requests completed after this time. formatdate-time [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20completed_after%20%3E%20(schema)>) completed\_before: Optional\[Union\[str, datetime]] Retrieve requests completed before this time. formatdate-time [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20completed_before%20%3E%20(schema)>) created\_after: Optional\[Union\[str, datetime]] Retrieve requests created after this time. formatdate-time [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20created_after%20%3E%20(schema)>) created\_before: Optional\[Union\[str, datetime]] Retrieve requests created before this time. formatdate-time [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20created_before%20%3E%20(schema)>) request\_type: Optional\[str] Requested information from request. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20request_type%20%3E%20(schema)>) sort\_by: Optional\[str] Field to sort results by. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20sort_by%20%3E%20(schema)>)
sort\_order: Optional\[Literal\["asc", "desc"]] Sort order (asc or desc). One of the following: "asc" Link to this property "desc" Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20sort_order%20%3E%20(schema)>)
status: Optional\[Literal\["open", "accepted", "reported", 3 more]] Request Status. One of the following: "open" Link to this property "accepted" Link to this property "reported" Link to this property "approved" Link to this property "completed" Link to this property "declined" Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%20default%20%3E%20(param)%20status%20%3E%20(schema)>) ##### ReturnsExpand Collapse
class ListItem: … id: str UUID. maxLength36 Link to this property created: datetime Request creation time. formatdate-time Link to this property
priority: Literal\["routine", "high", "urgent"] One of the following: "routine" Link to this property "high" Link to this property "urgent" Link to this property
Link to this property request: str Requested information from request. Link to this property summary: str Brief description of the request. Link to this property
tlp: Literal\["clear", "amber", "amber-strict", 2 more] The CISA defined Traffic Light Protocol (TLP). One of the following: "clear" Link to this property "amber" Link to this property "amber-strict" Link to this property "green" Link to this property "red" Link to this property
Link to this property updated: datetime Request last updated time. formatdate-time Link to this property completed: Optional\[datetime] Request completion time. formatdate-time Link to this property message\_tokens: Optional\[int] Tokens for the request messages. Link to this property readable\_id: Optional\[str] Readable Request ID. Link to this property
status: Optional\[Literal\["open", "accepted", "reported", 3 more]] Request Status. One of the following: "open" Link to this property "accepted" Link to this property "reported" Link to this property "approved" Link to this property "completed" Link to this property "declined" Link to this property
Link to this property tokens: Optional\[int] Tokens for the request. Link to this property
[Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(model)%20list_item%20%3E%20(schema)>) ### List Requests Python HTTPTypeScriptPythonGoTerraform ``` 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) ``` 200 example ``` { "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 } ] } ``` ##### Returns Examples 200 example ``` { "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 } ] } ```