​
Welcome to RippleCore API

RippleCore is a social impact evidence platform that transforms employee wellbeing and community engagement into verified, compliance-ready evidence packages for ESG reporting. The API provides programmatic access to four evidence modules:
  • Kindness & Recognition - Track peer recognition and community impact
  • Volunteer Management - GPS-verified volunteer activities with QR check-in
  • Donation Tracking - Multi-currency donation recording with tax documentation
  • Wellbeing Surveys - Employee wellbeing monitoring (12 surveys/year limit)

Complete API Specification

View the OpenAPI 3.0 specification for all endpoints

​
Authentication

All API endpoints require Bearer token authentication using better-auth. Include the token in the Authorization header: 
Authorization: Bearer your-jwt-token

​
Multi-Tenant Architecture

All data is organization-scoped using the activeOrganizationId from your authentication session. Every request automatically filters data to your organization’s records.

​
Rate Limits & Business Rules

  • Wellbeing Surveys: Maximum 12 surveys per user per year (returns 429 when exceeded)
  • Volunteer Verification: GPS/QM check-in required for verification levels 30-100
  • License Enforcement: API calls respect your organization’s license tier limits
  • Caching: Evidence data cached for 5 minutes for optimal performance

​
Response Format

All successful responses follow this structure: 
{
  "data": { /* response data */ }
}
Error responses include appropriate HTTP status codes and error details: 
{
  "error": "Error message",
  "details": { /* validation errors */ }
}