--- title: Get Passive DNS by IP --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Intel](https://developers.cloudflare.com/api/go/resources/intel) [DNS](https://developers.cloudflare.com/api/go/resources/intel/subresources/dns) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get Passive DNS by IP client.Intel.DNS.List(ctx, params) (\*V4PagePagination\[[DNS]()], error) GET/accounts/{account\_id}/intel/dns Gets a list of all the domains that have resolved to a specific IP address. ##### 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) `Intel Write``Intel Read` ##### ParametersExpand Collapse
params DNSListParams AccountID param.Field\[string] Path param: Identifier. maxLength32 Link to this property IPV4 param.Field\[string]Optional Query param Link to this property Page param.Field\[float64]Optional Query param: Requested page within paginated list of results. Link to this property PerPage param.Field\[float64]Optional Query param: Maximum number of results requested. Link to this property
StartEndParams param.Field\[DNSListParamsStartEndParams]Optional Query param End TimeOptional Defaults to the current date. formatdate Link to this property Start TimeOptional Defaults to 30 days before the end parameter value. formatdate Link to this property
Link to this property
[Link to this property](<#(resource)%20intel.dns%20%3E%20(method)%20list%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type DNS struct{…} Count float64Optional Total results returned based on your search parameters. Link to this property Page float64Optional Current page within paginated list of results. Link to this property PerPage float64Optional Number of results per page of results. Link to this property
ReverseRecords \[]DNSReverseRecordOptional Reverse DNS look-ups observed during the time period. FirstSeen TimeOptional First seen date of the DNS record during the time period. formatdate Link to this property Hostname stringOptional Hostname that the IP was observed resolving to. Link to this property LastSeen TimeOptional Last seen date of the DNS record during the time period. formatdate Link to this property
Link to this property
[Link to this property](<#(resource)%20intel.dns%20%3E%20(model)%20dns%20%3E%20(schema)>) ### Get Passive DNS by IP Go HTTPTypeScriptPythonGoTerraform ``` package main import ( "context" "fmt" "github.com/cloudflare/cloudflare-go" "github.com/cloudflare/cloudflare-go/intel" "github.com/cloudflare/cloudflare-go/option" ) func main() { client := cloudflare.NewClient( option.WithAPIToken("Sn3lZJTBX6kkg7OdcBUAxOO963GEIyGQqnFTOFYY"), ) page, err := client.Intel.DNS.List(context.TODO(), intel.DNSListParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) 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": { "count": 1, "page": 1, "per_page": 20, "reverse_records": [ { "first_seen": "2021-04-01", "hostname": "hostname", "last_seen": "2021-04-30" } ] }, "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000 } } ``` ##### 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": { "count": 1, "page": 1, "per_page": 20, "reverse_records": [ { "first_seen": "2021-04-01", "hostname": "hostname", "last_seen": "2021-04-30" } ] }, "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000 } } ```