--- title: List Requests --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Cloudforce One](https://developers.cloudflare.com/api/go/resources/cloudforce_one) [Requests](https://developers.cloudflare.com/api/go/resources/cloudforce_one/subresources/requests) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List Requests client.CloudforceOne.Requests.List(ctx, params) (\*SinglePage\[[ListItem]()], error) 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

params RequestListParams

AccountID param.Field\[string] Path param: Identifier. maxLength32 Link to this property Page param.Field\[int64] Body param: Page number of results. Link to this property PerPage param.Field\[int64] Body param: Number of results per page. Link to this property CompletedAfter param.Field\[Time]Optional Body param: Retrieve requests completed after this time. formatdate-time Link to this property CompletedBefore param.Field\[Time]Optional Body param: Retrieve requests completed before this time. formatdate-time Link to this property CreatedAfter param.Field\[Time]Optional Body param: Retrieve requests created after this time. formatdate-time Link to this property CreatedBefore param.Field\[Time]Optional Body param: Retrieve requests created before this time. formatdate-time Link to this property RequestType param.Field\[string]Optional Body param: Requested information from request. Link to this property SortBy param.Field\[string]Optional Body param: Field to sort results by. Link to this property

SortOrder param.Field\[RequestListParamsSortOrder]Optional Body param: Sort order (asc or desc).

const RequestListParamsSortOrderAsc RequestListParamsSortOrder = "asc" Link to this property const RequestListParamsSortOrderDesc RequestListParamsSortOrder = "desc" Link to this property

Link to this property

Status param.Field\[RequestListParamsStatus]Optional Body param: Request Status.

const RequestListParamsStatusOpen RequestListParamsStatus = "open" Link to this property const RequestListParamsStatusAccepted RequestListParamsStatus = "accepted" Link to this property const RequestListParamsStatusReported RequestListParamsStatus = "reported" Link to this property const RequestListParamsStatusApproved RequestListParamsStatus = "approved" Link to this property const RequestListParamsStatusCompleted RequestListParamsStatus = "completed" Link to this property const RequestListParamsStatusDeclined RequestListParamsStatus = "declined" Link to this property

Link to this property

[Link to this property](<#(resource)%20cloudforce_one.requests%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse

type ListItem struct{…}

ID string UUID. maxLength36 Link to this property Created Time Request creation time. formatdate-time Link to this property

Priority ListItemPriority

One of the following: const ListItemPriorityRoutine ListItemPriority = "routine" Link to this property const ListItemPriorityHigh ListItemPriority = "high" Link to this property const ListItemPriorityUrgent ListItemPriority = "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 ListItemTLP The CISA defined Traffic Light Protocol (TLP).

One of the following: const ListItemTLPClear ListItemTLP = "clear" Link to this property const ListItemTLPAmber ListItemTLP = "amber" Link to this property const ListItemTLPAmberStrict ListItemTLP = "amber-strict" Link to this property const ListItemTLPGreen ListItemTLP = "green" Link to this property const ListItemTLPRed ListItemTLP = "red" Link to this property

Link to this property Updated Time Request last updated time. formatdate-time Link to this property Completed TimeOptional Request completion time. formatdate-time Link to this property MessageTokens int64Optional Tokens for the request messages. Link to this property ReadableID stringOptional Readable Request ID. Link to this property

Status ListItemStatusOptional Request Status.

One of the following: const ListItemStatusOpen ListItemStatus = "open" Link to this property const ListItemStatusAccepted ListItemStatus = "accepted" Link to this property const ListItemStatusReported ListItemStatus = "reported" Link to this property const ListItemStatusApproved ListItemStatus = "approved" Link to this property const ListItemStatusCompleted ListItemStatus = "completed" Link to this property const ListItemStatusDeclined ListItemStatus = "declined" Link to this property

Link to this property Tokens int64Optional 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 Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/cloudforce_one" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIKey("144c9defac04969c7bfad8efaa8ea194"), option.WithAPIEmail("user@example.com"), ) page, err := client.CloudforceOne.Requests.List(context.TODO(), cloudforce_one.RequestListParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), Page: cloudflare.F(int64(0)), PerPage: cloudflare.F(int64(10)), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", page) } ``` 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 } ] } ```