> ## Documentation Index
> Fetch the complete documentation index at: https://docs.encrata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# IP Geolocation

> Locate an IP address city, region, country, coordinates, network owner (ASN & company), reverse DNS, timezone, and cloud provider.

## Authentication

Requires an API key in the `Authorization` header.

```bash theme={"dark"}
Authorization: Bearer YOUR_API_KEY
```

## Request

<ParamField body="ip" type="string" required>
  The IP address to locate (IPv4 or IPv6).
</ParamField>

## Response

Returns the standard IP lookup shape with only the geolocation sections populated: `location`, `flag`, `asn`, `company`, `domains`, `reverse_dns`, `timezone`, `currency`, and `cloud`. A focused, faster lookup that only calls the providers these sections need.

<ResponseExample>
  ```json theme={"dark"}
  {
    "query": "8.8.8.8",
    "ip": "8.8.8.8",
    "credits": 1,
    "location": { "city": "Mountain View", "region": "California", "country": "United States", "latitude": 37.4056, "longitude": -122.0775 },
    "asn": { "asn": 15169, "name": "Google LLC", "domain": "google.com" },
    "company": { "name": "Google LLC", "domain": "google.com", "type": "hosting" },
    "reverse_dns": "dns.google",
    "cloud": { "is_cloud": true, "provider": "Google Cloud" }
  }
  ```
</ResponseExample>

## Credits

1 credit per lookup.