Moderation Endpoints (US Only)

All moderation endpoints are in the api/us/ directory and are specific to the US version of the app.

Get Moderation Status

File: api/us/getModerationStatus.php Method: POST Auth: Required JWT

Returns the current moderation status for a user or chat room.

Update Moderation Status

File: api/us/updateModerationStatus.php Method: POST Auth: Required JWT

Updates the moderation status (e.g., marking a moderation case as resolved).

Add Moderator

File: api/us/addModerator.php Method: POST Auth: Required JWT

Assigns moderator role to a user for a chat room.

Remove Moderator

File: api/us/removeModerator.php Method: POST Auth: Required JWT

Removes moderator role from a user.

Rate Landlord

File: api/us/rateLandlord.php Method: POST Auth: Required JWT

Submits a landlord/property operator rating.

Get Landlord Review Data

File: api/us/getLandlordReviewData.php Method: POST Auth: Required JWT

Returns review data for landlords/property operators.

Get Landlords

File: api/us/getLandlords.php Method: POST Auth: Required JWT

Returns list of landlords/property operators.

Subscribed to Plus

File: api/us/subscribedToPlus.php Method: POST Auth: Required JWT

Checks if a user is subscribed to Housr Plus.

Moderation System Overview

The US moderation system manages chat room disputes and reviews:

Tables Involved

Table	Purpose
`chat_room_moderation`	Moderation cases (room_id, status: 1=open, 2=resolved)
`ratings_moderation`	Moderation ratings (moderation_id, user_id)
`ratings_periods`	Review periods (start_date, end_date)
`ratings_students`	Student-to-student ratings (tenant_id, created_at)
`ratings_users`	Aggregated user ratings (user_id, rating, rating_count)

Moderation Check in Login/SSO

During US login and SSO auth, the API checks:

Moderation Rating Due: Whether the user has unrated resolved moderation cases
Review Period: Whether an active review period exists and the user hasn’t submitted reviews yet

These flags are returned in the login response:


{
  "moderationRatingDue": true,
  "reviewPeriod": true
}

The mobile app uses these flags to prompt users to complete their ratings.

Rate Good Vibes

File: api/rateGoodvibes.php Method: POST Auth: Required JWT

Submits a “good vibes” rating (positive feedback).

Rate Match Preference

File: api/rateMatchpreference.php Method: POST Auth: Required JWT

Rates match preferences.

Rate Moderator

File: api/rateModerator.php Method: POST Auth: Required JWT

Rates a moderator’s handling of a case.