Facilitron Public APIs (v1)

Schemas

PropertyDto

_idstring · ObjectId · required
The unique identifier (_id) of the property
namestring · required
The name of the property
u_idstring · uuid · required
The unique identifier (u_id) of the property
addressstring · required
The address of the property
citystring · required
The city of the property
zipstring · required
The zip code of the property
statestring · required
The state of the property
timezonestring · required
The timezone of the property
propertiesstring[] · required
Array of property IDs (_id) that are children of this property

FacilityDto

property_idstring · ObjectId · required
The unique identifier (_id) of the property
_idstring · ObjectId · required
The unique identifier (_id) of the facility
u_idstring · uuid · required
The unique identifier (u_id) of the facility
namestring · required
The name of the facility
capacitynumber | null · required
The capacity of the facility
typestring · required
The type of the facility
search_termstring · required
The search term for the facility

EventDto

_idstring · required
short_idstring · required
rate_categorystring · required
statusstring · required
external_system_event_idstring | null · required
created_by_external_apiboolean · required
namestring · required
activity_typerequired
attendancenumber · required
property_idstring · required
timeslotsobject[] · required
submit_datestring · required
typestring · required
property_timezonestring · required
renterrequired

TimeslotDto

external_system_timeslot_idstring | null · pattern: ^[a-zA-Z0-9._-]+$ · required
The unique identifier of the timeslot from the external system. Alphanumeric plus ‘.’, ‘-’, and ‘_’ allowed.
activity_namestring | null · required
Descriptive name or note for the timeslot activity
facilityobject · required
Facility where the timeslot takes place
start_datetimestring · date-time · required
Start time of the timeslot in ISO 8601 format
end_datetimestring · date-time · required
End time of the timeslot in ISO 8601 format
statusstring · enum · required
Indicates the status of the timeslot. Can be active or suspended.
Enum values:
active
suspended

ActivityTypeDto

_idnumber · required
namestring · required

TimeslotFacilityDto

_idstring · ObjectId · required
The unique identifier (_id) of the facility
u_idstring · uuid · required
The unique identifier (u_id) of the facility
namestring · required
The name of the facility
capacitynumber | null · required
The capacity of the facility
typestring · required
The type of the facility

CancelEventSuccessResponse

messagestring · required
message_codestring · required
eventobject · required
invocation_idstring · uuid · required

UpdateTimeslotSuccessResponse

messagestring · required
message_codestring · required
timeslotobject · required
invocation_idstring · uuid · required

GetEventByIdResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
eventobject · required

GetEventsByFacilityIdResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
eventsobject[] · required
List of events which include the requested facility

GetEventsByPropertyIdResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
eventsobject[] · required
List of events which belong to the requested property

GetFacilitiesByPropertyIdResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
facilitiesobject[] · required
A list of all facilities that belong to the requested property (e.g., school)

GetPropertyByIdResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
propertyobject · required
Property details

GetAllPropertiesResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
propertiesobject[] · required
List of all properties (e.g., schools) that the API user has access to

CreateTimeslotDto

external_system_timeslot_idstring · minLength: 3 · maxLength: 50 · pattern: ^[a-zA-Z0-9._-]+$ · required
The unique identifier of the timeslot from the external system. Alphanumeric plus ‘.’, ‘-’, and ‘_’ allowed.
start_datetimestring · date-time · required
Start time of the timeslot in ISO 8601 format (local to the property timezone)
end_datetimestring · date-time · required
End time of the timeslot in ISO 8601 format (local to the property timezone)
facility_u_idstring · minLength: 1 · maxLength: 50 · required
Facility UID where the event takes place

activity_namestring · maxLength: 250
Descriptive name or note for the timeslot activity

CreateEventDto

external_system_event_idstring · minLength: 3 · maxLength: 50 · pattern: ^[a-zA-Z0-9._-]+$ · required
External event ID. Alphanumeric plus ".", "-", and "_" allowed
event_typestring · enum · required
The type of event (e.g. "reservation", "maintenance-block"). Always "reservation" for now
Enum values:
reservation
maintenance-block
namestring · minLength: 1 · maxLength: 100 · required
Human-readable event title. Used for display and identification in UI/logs. Length: 1–100 characters.
renter_emailstring · email · required
Renter email address associated with the event. Used to identify the renter/contact for notifications and reservation context. Format: RFC-compliant email string.
statusstring · enum · required
Event status for newly created events. Currently only approved is supported for this endpoint.
Enum values:
approved
activity_type_idnumber · required
Activity type identifier used to categorize the event. Must reference a valid activity type configured in the system.
timeslotsobject[] · required
Timeslots to create under this event. At least one timeslot is required. For multi-timeslot events, provide one item per timeslot in the desired schedule.

attendancenumber · min: 0 · max: 500000
Expected attendance headcount for the event. Used for capacity-related workflows and reporting. If omitted, defaults to 0. Range: 0–500,000.
Default: 0
renter_ownerstring
Optional renter-owner identifier to associate the event with a specific renter owner record. If omitted, the reservation is created as a personal renter (no renter owner association). Provide an existing owner/property identifier to link the renter owner to this event.
event_log_messagestring · maxLength: 250
Optional audit note for the event creation request. Stored for traceability and may appear in logs/history. May be omitted or provided as an empty string. Max length: 250.

CreatedEventDto

external_system_event_idstring · minLength: 3 · maxLength: 50 · pattern: ^[a-zA-Z0-9._-]+$ · required
External event ID. Alphanumeric plus ".", "-", and "_" allowed
_idstring · ObjectId · required
Internal Facilitron event ID
short_idstring · uuid · required
Short public ID of the event
has_conflictboolean · required
Indicates whether the event creation caused a conflict

UpdateTimeslotDto

start_datetimestring · date-time · required
New start date-time for the timeslot in the facility/owner local time. Cannot be older than 7 days in the past. Must be at least 1 minute earlier than end_datetime. Must be on the same calendar day as end_datetime. Format: ISO 8601 without timezone/offset (e.g. YYYY-MM-DDTHH:mm:ss).
end_datetimestring · date-time · required
New end date-time for the timeslot in the facility/owner local time. Must be at least 1 minute later than start_datetime. Must be on the same calendar day as start_datetime. Cannot be more than 2 years in the future. Format: ISO 8601 without timezone/offset (e.g. YYYY-MM-DDTHH:mm:ss).

activity_namestring | null · maxLength: 250
Optional activity name update. If omitted, activity_name is not changed. If provided as null or empty string, activity_name is cleared (set to empty). If provided as a string, activity_name is updated to that value.
facility_u_idstring · maxLength: 50
Optional facility UID update. If omitted, facility_u_id is not changed. If provided, current facility_u_id is replaced with the provided valid non-empty facility UID.
event_log_messagestring · maxLength: 250
Optional audit note explaining the change. Stored for traceability and may appear in logs/history. May be omitted or provided as an empty string.

UpdatedTimeslotDto

_idstring · required
Facilitron timeslot identifier (internal). Format: string.
external_system_timeslot_idstring · required
Timeslot identifier in the source/external system. Format: string.
start_datetimestring · date-time · required
Start datetime (local, no timezone/offset). Format: YYYY-MM-DDTHH:mm:ss.
end_datetimestring · date-time · required
End datetime (local, no timezone/offset). Format: YYYY-MM-DDTHH:mm:ss.

UpdateTimeslotResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
timeslotobject · required

CancelEventDto

statusstring · enum · required
New status of the event. Must be "cancelled".
Enum values:
cancelled

event_log_messagestring · maxLength: 250
Optional log message for event cancellation.

CancelledEventDto

external_system_event_idstring · minLength: 3 · maxLength: 50 · pattern: ^[a-zA-Z0-9._-]+$ · required
External event ID. Alphanumeric plus ".", "-", and "_" allowed
_idstring · ObjectId · required
Internal Facilitron event ID
short_idstring · uuid · required
Short public ID of the event

CancelEventResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
eventobject · required

CreateEventResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
eventobject · required

BadRequestError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

UnauthorizedError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

ForbiddenError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

NotFoundError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

TooManyRequestsError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

InternalServerError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

ConflictError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

BadGatewayError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

ServiceUnavailableError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

GatewayTimeoutError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

RenterDto

_uidstring · required
renter_orgstring | null · required
first_namestring · required
last_namestring · required
email_addressstring · required

Facilitron Public APIs (v1)

Schemas

PropertyDto

_idstring · ObjectId · required
The unique identifier (_id) of the property
namestring · required
The name of the property
u_idstring · uuid · required
The unique identifier (u_id) of the property
addressstring · required
The address of the property
citystring · required
The city of the property
zipstring · required
The zip code of the property
statestring · required
The state of the property
timezonestring · required
The timezone of the property
propertiesstring[] · required
Array of property IDs (_id) that are children of this property

FacilityDto

property_idstring · ObjectId · required
The unique identifier (_id) of the property
_idstring · ObjectId · required
The unique identifier (_id) of the facility
u_idstring · uuid · required
The unique identifier (u_id) of the facility
namestring · required
The name of the facility
capacitynumber | null · required
The capacity of the facility
typestring · required
The type of the facility
search_termstring · required
The search term for the facility

EventDto

_idstring · required
short_idstring · required
rate_categorystring · required
statusstring · required
external_system_event_idstring | null · required
created_by_external_apiboolean · required
namestring · required
activity_typerequired
attendancenumber · required
property_idstring · required
timeslotsobject[] · required
submit_datestring · required
typestring · required
property_timezonestring · required
renterrequired

TimeslotDto

external_system_timeslot_idstring | null · pattern: ^[a-zA-Z0-9._-]+$ · required
The unique identifier of the timeslot from the external system. Alphanumeric plus ‘.’, ‘-’, and ‘_’ allowed.
activity_namestring | null · required
Descriptive name or note for the timeslot activity
facilityobject · required
Facility where the timeslot takes place
start_datetimestring · date-time · required
Start time of the timeslot in ISO 8601 format
end_datetimestring · date-time · required
End time of the timeslot in ISO 8601 format
statusstring · enum · required
Indicates the status of the timeslot. Can be active or suspended.
Enum values:
active
suspended

ActivityTypeDto

_idnumber · required
namestring · required

TimeslotFacilityDto

_idstring · ObjectId · required
The unique identifier (_id) of the facility
u_idstring · uuid · required
The unique identifier (u_id) of the facility
namestring · required
The name of the facility
capacitynumber | null · required
The capacity of the facility
typestring · required
The type of the facility

CancelEventSuccessResponse

messagestring · required
message_codestring · required
eventobject · required
invocation_idstring · uuid · required

UpdateTimeslotSuccessResponse

messagestring · required
message_codestring · required
timeslotobject · required
invocation_idstring · uuid · required

GetEventByIdResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
eventobject · required

GetEventsByFacilityIdResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
eventsobject[] · required
List of events which include the requested facility

GetEventsByPropertyIdResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
eventsobject[] · required
List of events which belong to the requested property

GetFacilitiesByPropertyIdResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
facilitiesobject[] · required
A list of all facilities that belong to the requested property (e.g., school)

GetPropertyByIdResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
propertyobject · required
Property details

GetAllPropertiesResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
propertiesobject[] · required
List of all properties (e.g., schools) that the API user has access to

CreateTimeslotDto

external_system_timeslot_idstring · minLength: 3 · maxLength: 50 · pattern: ^[a-zA-Z0-9._-]+$ · required
The unique identifier of the timeslot from the external system. Alphanumeric plus ‘.’, ‘-’, and ‘_’ allowed.
start_datetimestring · date-time · required
Start time of the timeslot in ISO 8601 format (local to the property timezone)
end_datetimestring · date-time · required
End time of the timeslot in ISO 8601 format (local to the property timezone)
facility_u_idstring · minLength: 1 · maxLength: 50 · required
Facility UID where the event takes place

activity_namestring · maxLength: 250
Descriptive name or note for the timeslot activity

CreateEventDto

external_system_event_idstring · minLength: 3 · maxLength: 50 · pattern: ^[a-zA-Z0-9._-]+$ · required
External event ID. Alphanumeric plus ".", "-", and "_" allowed
event_typestring · enum · required
The type of event (e.g. "reservation", "maintenance-block"). Always "reservation" for now
Enum values:
reservation
maintenance-block
namestring · minLength: 1 · maxLength: 100 · required
Human-readable event title. Used for display and identification in UI/logs. Length: 1–100 characters.
renter_emailstring · email · required
Renter email address associated with the event. Used to identify the renter/contact for notifications and reservation context. Format: RFC-compliant email string.
statusstring · enum · required
Event status for newly created events. Currently only approved is supported for this endpoint.
Enum values:
approved
activity_type_idnumber · required
Activity type identifier used to categorize the event. Must reference a valid activity type configured in the system.
timeslotsobject[] · required
Timeslots to create under this event. At least one timeslot is required. For multi-timeslot events, provide one item per timeslot in the desired schedule.

attendancenumber · min: 0 · max: 500000
Expected attendance headcount for the event. Used for capacity-related workflows and reporting. If omitted, defaults to 0. Range: 0–500,000.
Default: 0
renter_ownerstring
Optional renter-owner identifier to associate the event with a specific renter owner record. If omitted, the reservation is created as a personal renter (no renter owner association). Provide an existing owner/property identifier to link the renter owner to this event.
event_log_messagestring · maxLength: 250
Optional audit note for the event creation request. Stored for traceability and may appear in logs/history. May be omitted or provided as an empty string. Max length: 250.

CreatedEventDto

external_system_event_idstring · minLength: 3 · maxLength: 50 · pattern: ^[a-zA-Z0-9._-]+$ · required
External event ID. Alphanumeric plus ".", "-", and "_" allowed
_idstring · ObjectId · required
Internal Facilitron event ID
short_idstring · uuid · required
Short public ID of the event
has_conflictboolean · required
Indicates whether the event creation caused a conflict

UpdateTimeslotDto

start_datetimestring · date-time · required
New start date-time for the timeslot in the facility/owner local time. Cannot be older than 7 days in the past. Must be at least 1 minute earlier than end_datetime. Must be on the same calendar day as end_datetime. Format: ISO 8601 without timezone/offset (e.g. YYYY-MM-DDTHH:mm:ss).
end_datetimestring · date-time · required
New end date-time for the timeslot in the facility/owner local time. Must be at least 1 minute later than start_datetime. Must be on the same calendar day as start_datetime. Cannot be more than 2 years in the future. Format: ISO 8601 without timezone/offset (e.g. YYYY-MM-DDTHH:mm:ss).

activity_namestring | null · maxLength: 250
Optional activity name update. If omitted, activity_name is not changed. If provided as null or empty string, activity_name is cleared (set to empty). If provided as a string, activity_name is updated to that value.
facility_u_idstring · maxLength: 50
Optional facility UID update. If omitted, facility_u_id is not changed. If provided, current facility_u_id is replaced with the provided valid non-empty facility UID.
event_log_messagestring · maxLength: 250
Optional audit note explaining the change. Stored for traceability and may appear in logs/history. May be omitted or provided as an empty string.

UpdatedTimeslotDto

_idstring · required
Facilitron timeslot identifier (internal). Format: string.
external_system_timeslot_idstring · required
Timeslot identifier in the source/external system. Format: string.
start_datetimestring · date-time · required
Start datetime (local, no timezone/offset). Format: YYYY-MM-DDTHH:mm:ss.
end_datetimestring · date-time · required
End datetime (local, no timezone/offset). Format: YYYY-MM-DDTHH:mm:ss.

UpdateTimeslotResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
timeslotobject · required

CancelEventDto

statusstring · enum · required
New status of the event. Must be "cancelled".
Enum values:
cancelled

event_log_messagestring · maxLength: 250
Optional log message for event cancellation.

CancelledEventDto

external_system_event_idstring · minLength: 3 · maxLength: 50 · pattern: ^[a-zA-Z0-9._-]+$ · required
External event ID. Alphanumeric plus ".", "-", and "_" allowed
_idstring · ObjectId · required
Internal Facilitron event ID
short_idstring · uuid · required
Short public ID of the event

CancelEventResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
eventobject · required

CreateEventResponse

messagestring · required
Response message
message_codestring · required
Response message code
invocation_idstring · uuid · required
Request ID
eventobject · required

BadRequestError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

UnauthorizedError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

ForbiddenError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

NotFoundError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

TooManyRequestsError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

InternalServerError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

ConflictError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

BadGatewayError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

ServiceUnavailableError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

GatewayTimeoutError

invocation_idstring · uuid · required
Request ID
messagestring · required
message_codestring · required

RenterDto

_uidstring · required
renter_orgstring | null · required
first_namestring · required
last_namestring · required
email_addressstring · required