# IP Lookup

## REQUEST

### Endpoint

```url
https://stopbot.net/api/iplookup?apikey={APIKEY}&ip={IP}
```

### Method

```
GET
```

### Parameters

* `apikey` (string, required): The API key provided to the user.
* `ip` (string, required): The IP address of the visitor.

### Example Request

```bash
curl "https://stopbot.net/api/iplookup?apikey=9ca6f45b2e9821b3a964c0f79cb67dc3&ip=1.1.1.1"
```

## **Example Response**

### Success Response

If the HTTP response is 200 (success response), it will generate the following response:

```json
{
  "ip": "1.1.1.1",
  "hostname": "",
  "asn": 13335,
  "company": "Cloudflare, Inc.",
  "isp": "Cloudflare, Inc.",
  "city": "Marble Bar",
  "district": "East Pilbara",
  "region": "Western Australia",
  "postcode": "",
  "country": "Australia",
  "countryCode": "AU",
  "latitude": -20.5,
  "longitude": 120.15,
  "timezone": "Australia\/Perth",
  "status": "success",
  "timeResponse": "2023-07-21 03:55:57"
}
```

### Description on successful response

* `hostname`: The visitor's hostname.
* `asn`: The Autonomous System Number (ASN) that identifies the internet service provider.
* `company`: The company associated with the visitor's IP.
* `isp`: The Internet Service Provider (ISP) name.
* `city`: The city where the visitor is located.
* `district`: The district or area associated with the IP address.
* `region`: The region where the visitor is located.
* `postcode`: The postal code associated with the IP address.
* `country`: The country where the visitor is located.
* `countryCode`: The ISO-3166 alpha-2 country code.
* `latitude`: The latitude coordinate of the IP address location.
* `longitude`: The longitude coordinate of the IP address location.
* `timezone`: The timezone of the IP address location.

### Failed Response

If the HTTP response is 400 or 401 (failed response), it will generate the following response:

```json
{
  "status": "failed",
  "timeResponse": "2023-06-8 23:00"
}
```

### Description on failed response:

* `status`: Response Status: The value is "failed" if the request fails.
* `timeResponse`: Date and time when the response was sent.