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

# Introduction

> GeoIPFetcher's Geolocation API is a modern and fast RESTful JSON API that allows you to get the geolocation of an IP address.

## Getting started

### Https

The GeoIPFetcher API requires all communications to be secured over HTTPS. Unsecured HTTP requests will be rejected.

### Api Versions

The GeoIPFetcher API is versioned, and the current version is `v1`. The version is part of the URL path, and the current version is `v1`. For example, the URL for the `v1` version of the API is `https://api.geoipfetcher.com/v1`.

### Api Key

An API key is required to use the GeoIPFetcher API. You can get your API key by signing up at [https://geoipfetcher.com](https://geoipfetcher.com).
To authenticate your requests, append your API key to the base url as a query parameter. For example, `https://api.geoipfetcher.com/v1?api_key=YOUR_API_KEY`.

### Base Url

```http
https://api.geoipfetcher.com/v1
```

### Api Endpoint

GeoIPFetcher's API only requires your API key. We will autodetect your IP address from the client's request.
You can override this behavior by appending the `ip_address` parameter.

```http
https://api.geoipfetcher.com/v1/\
?api_key=YOUR_API_KEY\
&ip_address=OPTIONAL_IP_ADDRESS
```

You can see a more detailed description of the request and response objects as well as test out requests in the [API Reference](/ip-geolocation/geoip/get-ip-geolocation-data).