RefreeG Developer API
Programmatically launch campaigns, manage donors, and scale social impact using our production-grade API infrastructure.
RESTful JSON
Predictable resource-oriented URLs and full JSON bodies.
Deterministic
Standard HTTP codes and unambiguous response objects.
Multi-Region
Native support for NGN, GHS, and other emerging markets.
Core Concepts
The RefreeG API is designed for robustness. Whether you're building a Discord bot, a mobile application, or any third-party interface, our API provides the hooks you need to manage the complete donor lifecycle.
Standard Response Format
Every response follows a deterministic structure, making integration across languages seamless.
{
"status": "success",
"data": { ... },
"meta": { "total": 100 } // Optional
}Rate Limiting
We enforce limits to preserve quality of service. Current global defaults:
- 60 Requests / Minute (default for all routes)
- 10 Requests / Minute (write-heavy endpoints like Report Campaign)
API Policy & Visibility
Campaigns created via API are **isolated** from the main RefreeG web portal. They do not appear in platform search results or the featured sections. You maintain full ownership of the user interface and the distribution channel.