# ClientIpGeoSnapshot

A model the API reference uses in a request or a response. The operation pages link every field typed as this model here.

Point-in-time snapshot of geolocation and ISP/ASN data resolved from the
transaction's `clientIpAddress` at the
enrichment stage of the orchestration pipeline.


This snapshot is <b>immutable</b> after creation. Subsequent updates to the
transaction (capture, refund, reversal, repeat, recurring-billing
materializations) MUST NOT overwrite it: the snapshot captures the geo
intelligence as it was at the moment the original transaction ran. If the
underlying IP intelligence database changes (DB-IP MMDB upgrade, ASN
reassignment, ISP rebrand, etc.) the persisted snapshot is preserved so
historical transactions remain auditable against the data the system saw
at runtime.



All fields are nullable because not every IP record carries every column:
fine-grained fields like `city` are sparse for IP ranges that
DB-IP can only localize to a country or region.

## Fields
- `countryA2` (string): ISO 3166-1 alpha-2 country code (e.g. `"US"`). (nullable)
- `countryName` (string): Country name in English (e.g. `"United States"`). (nullable)
- `region` (string): First-level administrative subdivision name (e.g. US state, Canadian  province, German Land). May be the ISO subdivision code in some  records and the localized name in others. (nullable)
- `city` (string): City name (e.g. `"Minneapolis"`). (nullable)
- `latitude` (number(double)): Approximate latitude of the IP block centroid in decimal degrees.  Resolution depends on the database tier: country, city, or block. (nullable)
- `longitude` (number(double)): Approximate longitude of the IP block centroid in decimal degrees. (nullable)
- `timeZone` (string): IANA time zone (e.g. `"America/Chicago"`). (nullable)
- `isp` (string): Internet Service Provider name. Available in editions that include  ISP data (Location+ISP / Full). (nullable)
- `organization` (string): Organization name registered for the IP block. May coincide with  `isp` for residential blocks but typically diverges for  hosting / corporate blocks. (nullable)
- `asNumber` (integer(int64)): Autonomous System Number (e.g. `15169` for Google). (nullable)
- `connectionType` (string): Connection / usage type as classified by DB-IP. Typical values:  `"Residential"`, `"Business"`, `"Hosting"`,  `"Mobile"`, `"Education"`, `"Government"`. The exact  vocabulary is supplied by the database; consumers should treat unknown  values as opaque. (nullable)

## See also

- [All documentation](https://devportal.demo.winkpg.io/llms.txt): the machine-readable index of every public page on this site.