Read response fields without guessing
Field presence depends on provider and coverage. Treat missing or null values as unavailable, and preserve attribution.
| Field or endpoint | Meaning |
|---|---|
| ip / ip_version | Requested address and 4 or 6. |
| country_code / country_name | ISO code / display name; nullable. |
| region_name / city | Approximate region and city; nullable, never a street address. |
| latitude / longitude | Approximate numeric coordinates or null; not GPS accuracy. |
| timezone | Provider-supplied timezone when available; nullable. |
| asn / as_name | Network number / description when covered. ASN country is not visitor geography. |
| source_id / dataset_version | Canonical provider and dataset version/checksum. |
| source_published_at | Known upstream release timestamp, otherwise null. |
| asn_source_id / asn_dataset_version | Separate provenance for ASN enrichment when available. |
| lookup_at | Lookup timestamp, not dataset age. |
| confidence | unknown, single_source, high_agreement or mixed_sources. Labels, not calibrated probabilities. |
| attributions / warnings | Provider credits and interpretation notes. |
| remaining / reset_at | Credits left and quota reset timestamp. |
Illustrative response excerpt
This shows a possible shape, not a live result or accuracy guarantee.
{
"ip": "8.8.8.8",
"ip_version": 4,
"country_code": "US",
"city": null,
"asn": 15169,
"as_name": "GOOGLE",
"source_id": "dbip-lite",
"dataset_version": "EXAMPLE_VERSION",
"source_published_at": null,
"confidence": "single_source",
"warnings": [
"IP geolocation is approximate."
],
"remaining": 999
}Comparison responses add sources and independent_country_providers. Batch responses use results. Standalone ASN returns a network payload, not the city-response shape.
Project fields without losing context
curl 'https://orig.ooo/v1/ip/8.8.8.8?fields=country_code,city,asn,as_name' \
-H "Authorization: Bearer $ORIGOOO_API_KEY"The response still includes required provenance, attribution, warnings and usage fields. Selecting fewer fields does not reduce its credit cost. Country confidence is qualitative agreement across independent sources, not a measured accuracy percentage. Treat a null city, missing ASN and null publication date independently.