API v3 Announcement
Important Changes Coming
We're introducing API v3 with enhanced features and improved reliability. As part of this update, we're also deprecating API v1 and v2.
What's Changing?
API v3 is Now Available
API v3 is the new version of our REST API that requires an API key for authentication. This change allows us to:
- Provide better rate limits and reliability
- Offer improved monitoring and support
- Ensure sustainable API access for all users
API v1 and v2 Deprecation
API v1 and v2 are being deprecated and will eventually require API keys as well. During the transition period:
- Gradual enforcement: Requests without API keys may receive error responses as we gradually enforce the requirement
- Deprecation headers: All v1/v2 responses include RFC 8594 compliant deprecation headers
- Sunset date: API v1 and v2 will be fully sunset in Q4 2026
Timeline
- Now: API v3 is available and requires API keys
- Q2 2026: Gradual enforcement begins for v1/v2 (some requests without API keys may fail)
- Q4 2026: API v1 and v2 are fully sunset (all requests require API keys)
What You Need to Do
- Get an API key: Register for a free API key from Geomi
- Migrate to v3: Update your code to use API v3 endpoints (see Migration Guide)
- Add API key headers: Include your API key in requests using the
X-API-Keyheader
Benefits of API v3
- Better performance: Optimized endpoints with improved response times
- Enhanced reliability: More stable API access with proper rate limiting
- Future-proof: Access to new features and improvements as they're released
- Better support: Improved monitoring helps us provide better support