Geolocation API
Endpoints
- Get Geolocation Status - Check whether geolocation is enabled and which MMDB file is loaded
- Upload MMDB File - Upload MaxMind GeoIP2 database file
- Enable Geolocation - Enable geolocation functionality
- Disable Geolocation - Disable geolocation functionality
Authentication
All endpoints require authentication using a Personal API Access Token.
Permissions
These are system admin settings endpoints (/apiops/settings/geolocation). They are not scoped to a project.
User must have system admin (sysAdmin) flag or the ADMIN authority on the account.
| Operation | Required access |
|---|---|
| Get Status | sysAdmin or ADMIN authority |
| Upload MMDB / Enable / Disable | sysAdmin or ADMIN authority |
Note
A valid API token without admin access returns 400 Bad Request with Unauthorized! Only users with ADMIN role can access this resource! (not HTTP 403).
Note
Get Geolocation Status returns status metadata only (enabled flag, file name, upload date). The MMDB file content is never returned - these databases are typically tens of megabytes and there is no APIops endpoint that downloads them.
Related Documentation
- Authentication Guide - How to obtain and use API tokens
- Error Handling - Error response formats