API for the .WORLD Mobile Application (Round Table, 41 Club, Ladies Circle, Agora Club, Tangent Club).
\nProduction: https://api.roundtable.world/v1/app/
Demo: https://api.roundtable-demo.world/v1/app/
Every call needs to be authenticated with your API Token via the Authorization header:
Authorization: Token <auth_token>\n\nDue to the multi-layered structure of .WORLD:
\nExceeding limits returns 429 Too Many Requests.
All responses are JSON
\nAll requests are JSON (unless specified)
\nPaginated endpoints use Django REST Framework's LimitOffsetPagination
\nAll URLs must end with a forward slash (/)
Only active members can authenticate
\nUnauthorized requests return 403 Forbidden
Authenticate a user and retrieve auth tokens.
\nReturns two auth tokens:
\nglobal_auth_token: Use for events, members, directory endpoints
local_auth_token: Use for /my-profile/ and /update-profile/ endpoints
Also includes user info (me) and club info (club).
Only active members can login
\nTokens automatically expire when user is no longer an Active Member
\nAuthentication endpoints for obtaining API tokens.
\n","_postman_id":"4473a6dc-0486-462d-9d72-5518bb768972","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Retrieve the authenticated user's full profile information.
\n⚠️ Use local_auth_token for this endpoint.
The response contains:
\ncross_family_optin: Whether user shares profile across familiesprofile_categories: Array of profile sectionsprivacy_settings: Array of privacy settings per fieldEach category has:
\ncategory_name: Display namedisplay_order: Sort order (3 × display_col × display_row)code: Category type identifiercan_edit: Whether user can edit this categoryvalues: Category-specific dataEach setting has:
\ntype: Field identifier (e.g., birth_date, address-12424)level: Privacy level (all, public, association, area, club, favorites, private)Enable or disable sharing your profile across different families (Round Table, 41 Club, Ladies Circle, etc.).
\n⚠️ Use local_auth_token for this endpoint.
Update privacy visibility level for a specific profile field.
\n⚠️ Use local_auth_token for this endpoint.
educationcompany-positiongenderbirth_datebirth_placeaddress-<id>phone-<id>secondary-email-<id>custom-field-category-<id>Update basic personal details.
\n⚠️ Use local_auth_token for this endpoint.
Update the user's home address.
\n⚠️ Use local_auth_token for this endpoint.
Update the user's billing/invoicing address.
\n⚠️ Use local_auth_token for this endpoint.
Update home and mobile phone numbers.
\n⚠️ Use local_auth_token for this endpoint.
Change the user's primary email address.
\n⚠️ Use local_auth_token for this endpoint.
400 error if email is already in useUpload a new profile picture.
\n⚠️ Use local_auth_token for this endpoint.
Update social media profile URLs.
\n⚠️ Use local_auth_token for this endpoint.
Add a new secondary email address.
\n⚠️ Use local_auth_token for this endpoint.
Update an existing secondary email address.
\n⚠️ Use local_auth_token for this endpoint.
Secondary email ID
\n","type":"text/plain"},"type":"any","value":"123","key":"id"}]}},"response":[],"_postman_id":"69055217-c7e5-4b18-b1de-37b12edefe8e"},{"name":"Delete Secondary Email","id":"542faa3f-fadd-4bee-ae5c-901dfc03347b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Remove a secondary email address.
\n⚠️ Use local_auth_token for this endpoint.
Secondary email ID
\n","type":"text/plain"},"type":"any","value":"123","key":"id"}]}},"response":[],"_postman_id":"542faa3f-fadd-4bee-ae5c-901dfc03347b"},{"name":"Create Education","id":"a6ccec4f-622a-4c80-8823-3abcb4c7d497","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Add a new education history entry.
\n⚠️ Use local_auth_token for this endpoint.
Update an existing education history entry.
\n⚠️ Use local_auth_token for this endpoint.
Same as Create Education endpoint.
\n","urlObject":{"path":["update-profile","education",":id",""],"host":["https://api.roundtable.world/v1/app"],"query":[],"variable":[{"id":"1670b062-7022-4f2d-8d8c-ad7d578236b7","description":{"content":"Education entry ID
\n","type":"text/plain"},"type":"any","value":"123","key":"id"}]}},"response":[],"_postman_id":"fef0d58d-1891-4a32-a1b7-6d03021be9b5"},{"name":"Delete Education","id":"35dfa30e-83b7-44f8-8210-494931c41e15","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Remove an education history entry.
\n⚠️ Use local_auth_token for this endpoint.
Education entry ID
\n","type":"text/plain"},"type":"any","value":"123","key":"id"}]}},"response":[],"_postman_id":"35dfa30e-83b7-44f8-8210-494931c41e15"},{"name":"Create Work Experience","id":"e79a946e-3824-4ee2-a9e0-b90b17282df7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Add a new work experience entry.
\n⚠️ Use local_auth_token for this endpoint.
Common sectors include:
\ninformation-technologyfinance-economicsconsulting-serviceslegalengineeringhealthcareUpdate an existing work experience entry.
\n⚠️ Use local_auth_token for this endpoint.
Same as Create Work Experience endpoint.
\n","urlObject":{"path":["update-profile","work",":id",""],"host":["https://api.roundtable.world/v1/app"],"query":[],"variable":[{"id":"d467d04f-8bc1-4537-93a7-1ad8944aca2a","description":{"content":"Work experience ID
\n","type":"text/plain"},"type":"any","value":"123","key":"id"}]}},"response":[],"_postman_id":"a8c21fa6-b17a-4f97-bb3b-b0142220c5e2"},{"name":"Delete Work Experience","id":"9a8b1704-388f-4e53-946b-2c4045cdfffe","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Remove a work experience entry.
\n⚠️ Use local_auth_token for this endpoint.
Work experience ID
\n","type":"text/plain"},"type":"any","value":"123","key":"id"}]}},"response":[],"_postman_id":"9a8b1704-388f-4e53-946b-2c4045cdfffe"},{"name":"Update Custom Field","id":"6fbe6707-e61a-48dc-9986-f6bd9d9421e7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Update a custom field value.
\n⚠️ Use local_auth_token for this endpoint.
choices_single and choices_multi, the list of possible options is available in the field's options array from GET /my-profile/Custom field ID
\n","type":"text/plain"},"type":"any","value":"123","key":"id"}]}},"response":[],"_postman_id":"6fbe6707-e61a-48dc-9986-f6bd9d9421e7"}],"id":"4103247d-7eea-4342-acce-0ad638203fbf","description":"Endpoints for managing the authenticated user's own profile.
\n⚠️ All endpoints in this folder require the local_auth_token
Retrieve a list of all possible functions to filter members by.
\n💡 Please cache this data locally as it rarely changes.
\nArray of function objects:
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Search for members across the organization with various filters.
\nAll fields are optional:
\nPaginated list (25 per page) sorted by last name:
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Retrieve another member's profile information.
\nReturns 403 Forbidden if:
⚠️ Only fields that the member has shared via privacy settings will be returned. Fields in the response may be limited based on the member's privacy preferences.
\nSimilar structure to /my-profile/ but with privacy-filtered data.
\nKey differences:
\nbilling_address is always nullemail_private is always nullMember ID (family level account ID)
\n","type":"text/plain"},"type":"any","value":"12345","key":"id"}]}},"response":[],"_postman_id":"3cc046f6-4965-418a-99cb-874c2decaf2d"}],"id":"3c5f580e-d343-4488-99bb-e90b0925f126","description":"Endpoints for searching and viewing member profiles.
\n","_postman_id":"3c5f580e-d343-4488-99bb-e90b0925f126","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Retrieve a list of all top-level organizations (families).
\nArray of family objects:
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Retrieve detailed information about a specific level (club, area, association, or family).
\nLevel ID
\n","type":"text/plain"},"type":"any","value":"100","key":"level_id"}]}},"response":[],"_postman_id":"5de4afa4-f498-42d8-a287-375405bf1a6b"},{"name":"Search Directory","id":"795267b3-03d6-4992-bfa8-1ea166e95d65","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"query\": \"Brussels\"\n}"},"url":"https://api.roundtable.world/v1/app/directory/search/","description":"Search for clubs by name.
\nPaginated list (25 per page) sorted by name:
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Retrieve all clubs within a specific association.
\nArray of club objects:
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Association level ID
\n","type":"text/plain"},"type":"any","value":"50","key":"level_id"}]}},"response":[],"_postman_id":"fe7026cb-04e8-4a8b-bbe1-3bd3cf986ef0"},{"name":"Query Directory","id":"9fa8b79d-86e8-4c5a-b60f-6a0a06abe6f6","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"https://api.roundtable.world/v1/app/directory/query/:level_ids/","description":"Retrieve limited information for multiple levels at once (optimized for Directory view).
\nComma-separated level IDs
\n","type":"text/plain"},"type":"any","value":"100,101,102","key":"level_ids"}]}},"response":[],"_postman_id":"9fa8b79d-86e8-4c5a-b60f-6a0a06abe6f6"}],"id":"4c004040-8d96-4b83-b79a-244505cb2f4d","description":"Endpoints for browsing the organizational directory structure.
\n","_postman_id":"4c004040-8d96-4b83-b79a-244505cb2f4d","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Retrieve the user's favorited members and levels.
\nAdd a member or level to favorites.
\nType: 'member' or 'level'
\n","type":"text/plain"},"type":"any","value":"member","key":"type"},{"id":"0636779f-974a-4d95-8368-71fd747edab0","description":{"content":"Member ID or Level ID
\n","type":"text/plain"},"type":"any","value":"12345","key":"id"}]}},"response":[],"_postman_id":"129650a0-625f-4939-9c11-86a048695aa5"},{"name":"Remove Favorite","id":"9fc508d0-3e59-4f7f-9610-48f302cc1101","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"DELETE","header":[],"url":"https://api.roundtable.world/v1/app/favorites/:type/:id/","description":"Remove a member or level from favorites.
\nType: 'member' or 'level'
\n","type":"text/plain"},"type":"any","value":"member","key":"type"},{"id":"c49f8d14-bcae-4df3-8993-9d9435f84c15","description":{"content":"Member ID or Level ID
\n","type":"text/plain"},"type":"any","value":"12345","key":"id"}]}},"response":[],"_postman_id":"9fc508d0-3e59-4f7f-9610-48f302cc1101"}],"id":"2c6c52b2-f12e-491e-9403-b5e4d03cfdb1","description":"Endpoints for managing favorite members and levels.
\n","_postman_id":"2c6c52b2-f12e-491e-9403-b5e4d03cfdb1","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Retrieve the top 3 upcoming highlighted events.
\nGet the default list of events (upcoming 12 months, own association, no filters).
\nPaginated list (10 per page) of Event objects.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Get all statutory events for the current statutory year.
\nPaginated list (10 per page) of Event objects.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Get all future events the user is attending.
\n50 days ago to 400 days in the future.
\nPaginated list (10 per page) of Event objects.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Search events with multiple filters.
\n⚠️ Note: All filters are combined with AND logic.
\nPaginated list (10 per page) of Event objects.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Endpoints for managing and viewing events.
\nRetrieve the authenticated user's organizational hierarchy.
\nReturns the user's levels at each tier:
\nEndpoints for retrieving organizational hierarchy information.
\n","_postman_id":"68d08b17-aa3e-4c50-908c-e5bb97be4f8a","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Enable or disable location sharing.
\nUpdate the user's current location.
\n⚠️ Rate Limited: 8 requests/minute
\nThe client must perform geocoding - the API expects location name and country to be provided.
\nFind members who are nearby and have opted-in to share their location.
\n⚠️ Rate Limited: 8 requests/minute
\nArray of nearby member objects:
\nReturns 403 if:
\nEndpoints for location-based features.
\n⚠️ These endpoints are rate-limited separately to 8 requests/token/minute.
\n","_postman_id":"3bbc27e2-7cf2-4642-9c16-9d49a2783662","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"Enable or disable birthday notifications for favorited members.
\nEndpoints for managing notification preferences.
\n","_postman_id":"ca4d3ddc-8445-442e-bece-af277dd2f678","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"Authorization"},{"key":"value","value":"