MaxMind Status
Fallback
Using geoip-lite
Database
No .mmdb loaded
GeoIP Source
GeoLite
IP resolver
ZIP Cities
328
BR entries
API Endpoints
GET
/geo
Lookup visitor IP from browser (auto-detect)
POST
/geo
Lookup by IP address (internal apps)
GET
/viaapi/:zip
Lookup city/state from ZIP via BrasilAPI
GET
/status
API health and config status
GET /geo - Response
// Visitor calls from browser, IP detected automatically
{
"zip": "01001000",
"state": "SP",
"city": "saopaulo",
"country": "BR"
}
POST /geo - Request / Response
// Request body:
{ "ip": "177.10.20.30" }
// Response:
{
"zip": "01001000",
"state": "SP",
"city": "saopaulo",
"country": "BR"
}
GET /viaapi/:zip - Response
// GET /viaapi/01001000
// Uses BrasilAPI (3s timeout), falls back to geolocation
// Response:
{
"state": "SP",
"city": "saopaulo"
}
Test IP Lookup
Result will appear here...
Test ZIP Lookup
Result will appear here...
MaxMind Database
No database loaded - using geoip-lite fallback
Click or drag a .mmdb file to upload
GeoLite2-City.mmdb or GeoIP2-City.mmdb (max 200MB)
Download the free GeoLite2-City database from maxmind.com and upload the .mmdb file here.