Developers
V1SocialClubs

Browse or search published public clubs

GET
/v1/social/clubs

Authorization

bearer
AuthorizationBearer <token>

In: header

Query Parameters

cursor?string
Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
limit?integer
Range1 <= value <= 50
Default20
q?string
Length2 <= length <= 80

Response Body

application/json

curl -X GET "https://example.com/v1/social/clubs"
{  "clubs": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "title": "string",      "summary": "string",      "visibility": "private",      "coverImage": {        "url": "http://example.com",        "alt": "string",        "source": "ai_generated"      },      "memberCount": 0,      "membershipStatus": "none",      "isOwner": true,      "moderationStatus": "pending",      "revision": 1,      "directoryVisible": false    }  ],  "nextCursor": "53a4a333-2825-45a4-80d2-5f430d088f36"}

Validate a welcome proof as active merchant owner/staff POST

Requires a Better Auth session and an active merchant owner/staff role checked from the database. Corporate users and unrelated merchants have no access; a live platform admin role does not bypass merchant membership. Returns no customer account, name, phone, identity-document or health data. Repeated collection returns already_redeemed.

Submit a text-only club for moderation POST

Anyone signed in can create a club. It defaults private. No submitted text is published before moderator approval; no image uploads or event creation are accepted.