--- title: List Requests --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api) [Cloudforce One](https://developers.cloudflare.com/api/resources/cloudforce_one) [Requests](https://developers.cloudflare.com/api/resources/cloudforce_one/subresources/requests) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Requests 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` ##### P ath ParametersExpand Collapse account\_id: string 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)>) ##### Body ParametersJSONExpand Collapse page: number Page number of results. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%200%20%3E%20(param)%20page%20%3E%20(schema)>) per\_page: number Number of results per page. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%200%20%3E%20(param)%20per_page%20%3E%20(schema)>) completed\_after: optional string 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)%200%20%3E%20(param)%20completed_after%20%3E%20(schema)>) completed\_before: optional string 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)%200%20%3E%20(param)%20completed_before%20%3E%20(schema)>) created\_after: optional string 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)%200%20%3E%20(param)%20created_after%20%3E%20(schema)>) created\_before: optional string 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)%200%20%3E%20(param)%20created_before%20%3E%20(schema)>) request\_type: optional string Requested information from request. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%200%20%3E%20(param)%20request_type%20%3E%20(schema)>) sort\_by: optional string Field to sort results by. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%200%20%3E%20(param)%20sort_by%20%3E%20(schema)>)

sort\_order: optional "asc"or "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)%200%20%3E%20(param)%20sort_order%20%3E%20(schema)>)

status: optional "open"or "accepted"or "reported"or 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)%200%20%3E%20(param)%20status%20%3E%20(schema)>) ##### ReturnsExpand Collapse

errors: array of object {code, message, documentation\_url, source }

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20errors>)

messages: array of object {code, message, documentation\_url, source }

code: number minimum1000 Link to this property message: string Link to this property documentation\_url: optional string Link to this property

source: optional object {pointer }

pointer: optional string Link to this property

Link to this property

[Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20messages>) success: true Whether the API call was successful. [Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20success>)

result: optional array of ListItem { id, created, priority, 9 more }

id: string UUID. maxLength36 Link to this property created: string Request creation time. formatdate-time Link to this property

priority: "routine"or "high"or "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: string Requested information from request. Link to this property summary: string Brief description of the request. Link to this property

tlp: "clear"or "amber"or "amber-strict"or 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: string Request last updated time. formatdate-time Link to this property completed: optional string Request completion time. formatdate-time Link to this property message\_tokens: optional number Tokens for the request messages. Link to this property readable\_id: optional string Readable Request ID. Link to this property

status: optional "open"or "accepted"or "reported"or 3 more Request Status.

Link to this property tokens: optional number Tokens for the request. Link to this property

[Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(network%20schema)%20%3E%20(property)%20result>) ### List Requests HTTP HTTPTypeScriptPythonGoTerraform ``` curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/cloudforce-one/requests \ -H 'Content-Type: application/json' \ -H "X-Auth-Email: $CLOUDFLARE_EMAIL" \ -H "X-Auth-Key: $CLOUDFLARE_API_KEY" \ -d '{ "page": 0, "per_page": 10, "completed_after": "2022-01-01T00:00:00Z", "completed_before": "2024-01-01T00:00:00Z", "created_after": "2022-01-01T00:00:00Z", "created_before": "2024-01-01T00:00:00Z", "request_type": "Victomology", "sort_by": "created" }' ``` 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 } ] } ```