Pass your API key in the Authorization header (recommended) or as a query string parameter.

GET https://app.bluesanta.net/api/v1/stats
Authorization: Bearer YOUR_API_KEY

Alternatively, as a query string:

GET https://app.bluesanta.net/api/v1/stats?api_key=YOUR_API_KEY

To request an API key, contact the platform administrator.

60 requests per IP per 60 seconds. Exceed the limit and you will receive a 429 response.

Platform-wide totals: total cleanups, kilograms of waste collected, active members, organizations, upcoming events, gallery photos, plus last-30-day counters and a top-states breakdown.

Example response

{
  "ok": true,
  "generated": "2026-06-20T10:00:00Z",
  "data": {
    "totals": {
      "cleanups_approved": 1234,
      "waste_collected_kg": 5678.9,
      "active_members": 890,
      "organizations": 12,
      "guilds": 7,
      "upcoming_events": 3,
      "gallery_photos": 245
    },
    "last_30_days": {
      "cleanups_approved": 87,
      "waste_collected_kg": 412.5
    },
    "top_states": [
      { "state": "Pulau Pinang", "submissions": 420, "total_kg": 1820.0 }
    ]
  }
}

Returns approved events from the platform that members can attend. Each row includes the title, date, location, organizer, RSVP/attendee counts, and an absolute poster-image URL. Default is upcoming — only events that haven't happened yet. Use when=past for completed events, or when=all for both. Official platform events are sorted first.

Query parameters

• when — upcoming (default), past, or all
• type — all (default), open, invite_only, or closed
• official — 1 to show only official events, 0 for non-official, omit for all
• page, limit — pagination (max limit 100)

Returns approved cleanup submission records (completed past activities, not events members can RSVP to). Each row includes the date, location, total weight, item count, member name, state, and organization.

Query parameters

• from, to — ISO dates YYYY-MM-DD (filters by submission date)
• state — filter by Malaysian state name (e.g. Pulau Pinang)
• page, limit — pagination (max limit 100)

Top users and/or top organizations, ranked by XP and waste collected. Each row includes rank, display name, state, XP, cleanup count, and total kilograms.

Query parameters

• type — users, organizations, or all (default)
• state — filter by state
• page, limit — pagination

Users must have opted in to public display. Organizations only appear if their admin has enabled "Show on scoreboard".

Approved event-gallery photos with absolute image URLs, captions, and the member's display name.

Only photos marked approved by an admin are returned. Image URLs are absolute and ready to render directly.

Need help?

For API access requests, additional endpoints, or integration support, contact the platform admin through the Report page.