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

# Geolocation and ISP

> City, region, country, and ISP for the agent endpoint, resolved by the Agent Experience Collector from the public IP address detected at the start of each Amazon Connect Contact.

The geolocation and ISP (internet service provider) fields identify where the agent endpoint connected from. The Agent Experience Collector resolves them from the agent's public IP address at the start of each Amazon Connect Contact.

## Schema

```json theme={null}
{
  "agentCity": "Melbourne",
  "agentRegion": "Victoria",
  "agentCountry": "Australia",
  "agentISP": "Bcd Networks Pty Ltd",
  "agentExternalIPAddress": "103.120.49.101",
  "agentIPAddress": "192.168.1.18"
}
```

## Fields

| Name                     | Type          | Required | Description                                                       | Example                |
| ------------------------ | ------------- | -------- | ----------------------------------------------------------------- | ---------------------- |
| `agentCity`              | string        | yes      | City of the public IP detected for the agent endpoint.            | `Melbourne`            |
| `agentRegion`            | string        | yes      | State or region of the public IP detected for the agent endpoint. | `Victoria`             |
| `agentCountry`           | string        | yes      | Country of the public IP detected for the agent endpoint.         | `Australia`            |
| `agentISP`               | string        | yes      | ISP name resolved from the agent's public IP.                     | `Bcd Networks Pty Ltd` |
| `agentExternalIPAddress` | string (IPv4) | yes      | Agent WAN IP address.                                             | `103.120.49.101`       |
| `agentIPAddress`         | string (IPv4) | yes      | Agent LAN IP address.                                             | `192.168.1.18`         |

## Notes

* All six fields are resolved once per Contact at connection time. If the agent's IP changes mid-contact (rare), the values reflect the IP at the moment the Contact started.
* `agentExternalIPAddress` and `agentIPAddress` also appear in the `network` object on the same contact record (see [Machine, browser, and network data](/docs/machine-browser-network)).
