--- title: List datasets --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Radar](https://developers.cloudflare.com/api/go/resources/radar) [Datasets](https://developers.cloudflare.com/api/go/resources/radar/subresources/datasets) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # List datasets client.Radar.Datasets.List(ctx, query) (\*[DatasetListResponse](), error) GET/radar/datasets Retrieves a list of datasets. ##### Security
API Token The preferred authorization scheme for interacting with the Cloudflare API. Create a token. **Example:**Authorization: Bearer Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY
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) `User Details Write``User Details Read` ##### ParametersExpand Collapse
query DatasetListParams
DatasetType param.Field\[DatasetListParamsDatasetType]Optional Filters results by dataset type. const DatasetListParamsDatasetTypeRankingBucket DatasetListParamsDatasetType = "RANKING\_BUCKET" Link to this property const DatasetListParamsDatasetTypeReport DatasetListParamsDatasetType = "REPORT" Link to this property
Link to this property Date param.Field\[Time]Optional Filters results by the specified date. formatdate Link to this property
Format param.Field\[DatasetListParamsFormat]Optional Format in which results will be returned. const DatasetListParamsFormatJson DatasetListParamsFormat = "JSON" Link to this property const DatasetListParamsFormatCsv DatasetListParamsFormat = "CSV" Link to this property
Link to this property Limit param.Field\[int64]Optional Limits the number of objects returned in the response. exclusiveMinimum minimum0 Link to this property Offset param.Field\[int64]Optional Skips the specified number of objects before fetching the results. minimum0 Link to this property
[Link to this property](<#(resource)%20radar.datasets%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type DatasetListResponse struct{…}
Datasets \[]DatasetListResponseDataset ID int64 Link to this property Description string Link to this property Meta unknown Link to this property Tags \[]string Link to this property Title string Link to this property Type string Link to this property
Link to this property
[Link to this property](<#(resource)%20radar.datasets%20%3E%20(model)%20DatasetListResponse%20%3E%20(schema)>) ### List datasets Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/option" "github.com/cloudflare/cloudflare-go/radar" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) datasets, err := client.Radar.Datasets.List(context.TODO(), radar.DatasetListParams{ }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", datasets.Datasets) } ``` 200 example ``` { "result": { "datasets": [ { "id": 3, "description": "This dataset contains a list of the op 20000 domains globally", "meta": {}, "tags": [ "global" ], "title": "Top bucket 20000 domains", "type": "RANKING_BUCKET" } ] }, "success": true } ``` ##### Returns Examples 200 example ``` { "result": { "datasets": [ { "id": 3, "description": "This dataset contains a list of the op 20000 domains globally", "meta": {}, "tags": [ "global" ], "title": "Top bucket 20000 domains", "type": "RANKING_BUCKET" } ] }, "success": true } ```