Introduction
Welcome to G17Eco API documentation!
What is G17Eco?
G17Eco empowers organisations, cities and nations to map, monitor, measure, manage and market their sustainability performance end to end. G17Eco uses ground-breaking technology to deliver trusted, comparable and timely impact data to empower all stakeholders with their decision making.
A simple, powerful and flexible sustainability platform.
Rate limits
The API implements rate limiting to ensure fair usage and system stability. When rate limits are exceeded, you'll receive a 429 Too Many Requests response.
Rate Limit Configuration
Standard Endpoints:
- Authenticated requests: 120 requests per 60 seconds
- Unauthenticated requests: 30 requests per 60 seconds
High-Volume Endpoints:
/value-list/lookupendpoint:- Authenticated: 500 requests per 60 seconds
- Unauthenticated: 100 requests per 60 seconds
Rate Limit Headers
Each response includes headers to help you track your rate limit status:
RateLimit-Policy: The rate limit policy applied (e.g.,120;w=60)RateLimit-Limit: Maximum requests allowed in the window (e.g.,120)RateLimit-Remaining: Requests remaining in current window (e.g.,115)RateLimit-Reset: Seconds until the limit resets (e.g.,10)
Best Practices for Rate Limiting
- Implement exponential backoff when receiving 429 responses
- Cache frequently accessed data like initiatives and value lists
- Use bulk endpoints where available (e.g.,
/value-list/lookup) - Monitor rate limit headers to adjust request patterns
- Spread requests over time rather than bursting
Treat these limits as maximums and don't generate unnecessary load.
Postman collection
Postman collection (opens in a new tab) available to quickly test out the available endpoints.