--- title: Get IP Overview --- [Skip to content](#_top) [API Reference](https://developers.cloudflare.com/api/go) [Intel](https://developers.cloudflare.com/api/go/resources/intel) [IPs](https://developers.cloudflare.com/api/go/resources/intel/subresources/ips) Copy Markdown Open in **Claude**Open in **ChatGPT**Open in **Cursor** --- **Copy Markdown****View as Markdown** # Get IP Overview client.Intel.IPs.Get(ctx, params) (\*\[] [IP](), error) GET/accounts/{account\_id}/intel/ip Gets the geolocation, ASN, infrastructure type of the ASN, and any security threat categories of an IP address. **Must provide ip query parameters.** For example, `/intel/ip?ipv4=1.1.1.1` or `/intel/ip?ipv6=2001:db8::1`. ##### 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 IPGetParams AccountID param.Field\[string] Path param: Identifier. maxLength32 Link to this property IPV4 param.Field\[string]Optional Query param Link to this property IPV6 param.Field\[string]Optional Query param Link to this property
[Link to this property](<#(resource)%20intel.ips%20%3E%20(method)%20get%20%3E%20(params)%20default>) ##### ReturnsExpand Collapse
type IPGetResponseEnvelopeResult \[]IP
BelongsToRef IPBelongsToRefOptional Specifies a reference to the autonomous systems (AS) that the IP address belongs to. ID stringOptional Link to this property Country stringOptional Link to this property Description stringOptional Link to this property
Type IPBelongsToRefTypeOptional Infrastructure type of this ASN. One of the following: const IPBelongsToRefTypeHostingProvider IPBelongsToRefType = "hosting\_provider" Link to this property const IPBelongsToRefTypeISP IPBelongsToRefType = "isp" Link to this property const IPBelongsToRefTypeOrganization IPBelongsToRefType = "organization" Link to this property
Link to this property Value stringOptional Link to this property
Link to this property IP stringOptional formatipv4 Link to this property
RiskTypes \[]IPRiskTypeOptional ID float64Optional Link to this property Name stringOptional Link to this property SuperCategoryID float64Optional Link to this property
Link to this property
[Link to this property](<#(resource)%20intel.ips%20%3E%20(method)%20get%20%3E%20(network%20schema)%20%3E%20(property)%20result>) ### Get IP Overview 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"), ) ips, err := client.Intel.IPs.Get(context.TODO(), intel.IPGetParams{ AccountID: cloudflare.F("023e105f4ecef8ad9ca31a8372d0c353"), }) if err != nil { panic(err.Error()) } fmt.Printf("%+v\n", ips) } ``` 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" } } ], "result": [ { "belongs_to_ref": { "id": "autonomous-system--2fa28d71-3549-5a38-af05-770b79ad6ea8", "country": "US", "description": "CLOUDFLARENET", "type": "hosting_provider", "value": "value" }, "ip": "192.0.2.0", "risk_types": [ { "id": 131, "name": "Phishing", "super_category_id": 21 } ] } ], "success": true, "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" } } ], "result": [ { "belongs_to_ref": { "id": "autonomous-system--2fa28d71-3549-5a38-af05-770b79ad6ea8", "country": "US", "description": "CLOUDFLARENET", "type": "hosting_provider", "value": "value" }, "ip": "192.0.2.0", "risk_types": [ { "id": 131, "name": "Phishing", "super_category_id": 21 } ] } ], "success": true, "result_info": { "count": 1, "page": 1, "per_page": 20, "total_count": 2000 } } ```