Stays API Reference
Stays API Reference
Section titled “Stays API Reference”The Stays service (port 8000) serves the Hospitality Business Unit.
Base URL
Section titled “Base URL”http://localhost:8000/api/Divisions
Section titled “Divisions”- Stay Overnight - Short-term hospitality
- Roommate Works - Long-term roommate matching
- Stay Match - Travel companion matching
Endpoints
Section titled “Endpoints”Authentication
Section titled “Authentication”POST /api/auth/register/POST /api/auth/login/POST /api/auth/verify-phone/POST /api/auth/refresh/User Profile
Section titled “User Profile”GET /api/users/me/PUT /api/users/me/PATCH /api/users/me/Listings (Stay Overnight)
Section titled “Listings (Stay Overnight)”GET /api/stays/listings/POST /api/stays/listings/GET /api/stays/listings/{id}/PUT /api/stays/listings/{id}/DELETE /api/stays/listings/{id}/Bookings
Section titled “Bookings”GET /api/stays/bookings/POST /api/stays/bookings/GET /api/stays/bookings/{id}/PUT /api/stays/bookings/{id}/OpenAPI Documentation
Section titled “OpenAPI Documentation”Interactive API documentation available at:
- Swagger UI:
http://localhost:8000/api/schema/swagger-ui/ - ReDoc:
http://localhost:8000/api/schema/redoc/ - OpenAPI JSON:
http://localhost:8000/api/schema/
Authentication
Section titled “Authentication”All endpoints require JWT authentication except registration and login.
Include token in header:
Authorization: Bearer <token>Coming Soon
Section titled “Coming Soon”Full endpoint documentation with request/response examples.