📘 Partner Events API

Retrieve public events linked to a partner referral code, with sorting, filtering, pagination, and dynamic event data.


🚀 Getting Started

To begin retrieving events, all you need is a valid partner referral code.

✅ Required Parameter

Parameter Type Description
referral_code string The unique referral code associated with a partner

🔹 Example Request

GET <https://3common.com/partner/events?referral_code=hello123>

This returns the first page (20 events) linked to the partner with referral code hello123.


⚙️ Optional Query Parameters

Parameter Type Default Description
page number 0 Zero-based page index
limit number 20 Max results per page (up to 100)
sort 'start' or 'end' or 'createdAt' 'start' Field to sort events by
direction 'asc' or 'desc' 'asc' Sort direction
filter 'all', 'upcoming', 'past' 'all' Filter based on event date category

🚀 Example Request

GET <https://3common.com/partner/events?referral_code=hello123&sort=createdAt&direction=desc&page=1&limit=10&filter=past>

This request retrieves the second page of past events, limited to 10 entries, sorted in descending order by creation date.


📦 Response Format