A CalendarEventCategory groups events by type or theme within a location. Categories appear as filters on the Events page of the Members Portal, letting customers quickly find relevant events. Events that share the same category are also shown as related events when a customer views the detail page of a specific event.
Assign categories to events via the EventCategories list on the CalendarEvent entity.
Authentication
This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header.
The authenticated user must be a full unrestricted administrator or have the CalendarEventCategory-List role.
Query Parameters
The page number to retrieve.
The number of records per page.
The property name to sort results by (e.g. Name, CreatedOn).
Sort direction. 1 for ascending, -1 for descending.
Filters
CalendarEventCategory_Business
Filter by the location this event category belongs to.
CalendarEventCategory_Title
Filter by category name shown as a filter on the Members Portal.
Range Filters
from_CalendarEventCategory_CreatedOn
Filter records created on or after this date. Format: YYYY-MM-DDTHH:mm.
to_CalendarEventCategory_CreatedOn
Filter records created on or before this date. Format: YYYY-MM-DDTHH:mm.
from_CalendarEventCategory_UpdatedOn
Filter records updated on or after this date. Format: YYYY-MM-DDTHH:mm.
to_CalendarEventCategory_UpdatedOn
Filter records updated on or before this date. Format: YYYY-MM-DDTHH:mm.
Code Examples
Simple listing
curl -X GET \
"https://spaces.nexudus.com/api/content/calendareventcategories?page=1&size=15&orderBy=Title&dir=1" \
-H "Authorization: Bearer YOUR_TOKEN"
Filtering by Title
curl -X GET \
"https://spaces.nexudus.com/api/content/calendareventcategories?CalendarEventCategory_Title=example-value&orderBy=Title&dir=1" \
-H "Authorization: Bearer YOUR_TOKEN"
Range filters
curl -X GET \
"https://spaces.nexudus.com/api/content/calendareventcategories?from_CalendarEventCategory_UpdatedOn=2025-01-01T00:00&to_CalendarEventCategory_UpdatedOn=2025-12-31T23:59&orderBy=UpdatedOn&dir=-1" \
-H "Authorization: Bearer YOUR_TOKEN"
Response
200
The list of CalendarEventCategory records matching the query. See the Get one CalendarEventCategory endpoint for the full list of properties returned for each record.
Number of records per page.
The field used for sorting.
The sort direction (1 = ascending, -1 = descending).
Index of the first item on the current page.
Index of the last item on the current page.
Total number of matching records across all pages.
Whether there is a next page of results.
Whether there is a previous page of results.
{
"Records": [
{
"BusinessId": 0,
"Title": "",
"CalendarEvents": [],
"Id": 87654321,
"UpdatedOn": "2025-01-15T10:30:00Z",
"CreatedOn": "2025-01-10T08:00:00Z",
"UniqueId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"UpdatedBy": "admin@example.com",
"IsNew": false,
"SystemId": null,
"ToStringText": "CalendarEventCategory Example",
"LocalizationDetails": null,
"CustomFields": null
}
],
"CurrentPageSize": 15,
"CurrentPage": 1,
"CurrentOrderField": "Title",
"CurrentSortDirection": 1,
"FirstItem": 1,
"HasNextPage": false,
"HasPreviousPage": false,
"LastItem": 1,
"PageNumber": 1,
"PageSize": 15,
"TotalItems": 1,
"TotalPages": 1
}