H

Hostel Management

Published byQuarj0
9/13/2026
Agent payments

Endpoints

112

auth
12

bookings
10

inventory
36

notifications
4

operations
14

organizations
8

payments
6

properties
14

reviews
8

What is the Hostel Management API?

Hostel booking, payments and operations API

Hostel Management API is available on the JoJ API marketplace. Subscribe with a single JoJ API key, call it through one gateway, and pay from one wallet — no separate account or contract with the provider.

Pricing & plans About this API FAQ Discussions More APIs by @quarj0 OpenAPI spec MCP server

Hostel Management API endpoints

  • POST/api/v1/auth/email/verification/

    POST /api/v1/auth/email/verification/

    Create or perform auth email verification.

  • POST/api/v1/auth/email/verification/confirm/

    POST /api/v1/auth/email/verification/confirm/

    Create or perform auth email verification confirm.

  • POST/api/v1/auth/logout/

    POST /api/v1/auth/logout/

    Create or perform auth logout.

  • GET/api/v1/auth/me/

    GET /api/v1/auth/me/

    Retrieve auth me.

  • PUT/api/v1/auth/me/

    PUT /api/v1/auth/me/

    Update auth me.

  • PATCH/api/v1/auth/me/

    PATCH /api/v1/auth/me/

    Partially update auth me.

  • POST/api/v1/auth/password/change/

    POST /api/v1/auth/password/change/

    Create or perform auth password change.

  • POST/api/v1/auth/password/reset/

    POST /api/v1/auth/password/reset/

    Create or perform auth password reset.

  • POST/api/v1/auth/password/reset/confirm/

    POST /api/v1/auth/password/reset/confirm/

    Create or perform auth password reset confirm.

  • POST/api/v1/auth/register/

    POST /api/v1/auth/register/

    Create or perform auth register.

  • POST/api/v1/auth/token/

    POST /api/v1/auth/token/

    Takes a set of user credentials and returns an access and refresh JSON web token pair to prove the authentication of those credentials.

  • POST/api/v1/auth/token/refresh/

    POST /api/v1/auth/token/refresh/

    Takes a refresh type JSON web token and returns an access type JSON web token if the refresh token is valid.

  • GET/api/v1/bookings/

    GET /api/v1/bookings/

    List bookings.

  • POST/api/v1/bookings/

    POST /api/v1/bookings/

    Create or perform bookings.

  • GET/api/v1/bookings/{id}/

    GET /api/v1/bookings/{id}/

    Retrieve bookings.

  • PUT/api/v1/bookings/{id}/

    PUT /api/v1/bookings/{id}/

    Update bookings.

  • PATCH/api/v1/bookings/{id}/

    PATCH /api/v1/bookings/{id}/

    Partially update bookings.

  • DELETE/api/v1/bookings/{id}/

    DELETE /api/v1/bookings/{id}/

    Delete bookings.

  • POST/api/v1/bookings/{id}/cancel/

    POST /api/v1/bookings/{id}/cancel/

    Create or perform bookings cancel.

  • POST/api/v1/bookings/{id}/check-in/

    POST /api/v1/bookings/{id}/check-in/

    Create or perform bookings check in.

  • POST/api/v1/bookings/{id}/check-out/

    POST /api/v1/bookings/{id}/check-out/

    Create or perform bookings check out.

  • GET/api/v1/bookings/availability/

    GET /api/v1/bookings/availability/

    Retrieve bookings availability.

  • GET/api/v1/inventory/beds/

    GET /api/v1/inventory/beds/

    List inventory beds.

  • POST/api/v1/inventory/beds/

    POST /api/v1/inventory/beds/

    Create or perform inventory beds.

  • GET/api/v1/inventory/beds/{id}/

    GET /api/v1/inventory/beds/{id}/

    Retrieve inventory beds.

  • PUT/api/v1/inventory/beds/{id}/

    PUT /api/v1/inventory/beds/{id}/

    Update inventory beds.

  • PATCH/api/v1/inventory/beds/{id}/

    PATCH /api/v1/inventory/beds/{id}/

    Partially update inventory beds.

  • DELETE/api/v1/inventory/beds/{id}/

    DELETE /api/v1/inventory/beds/{id}/

    Delete inventory beds.

  • GET/api/v1/inventory/blocks/

    GET /api/v1/inventory/blocks/

    List inventory blocks.

  • POST/api/v1/inventory/blocks/

    POST /api/v1/inventory/blocks/

    Create or perform inventory blocks.

  • GET/api/v1/inventory/blocks/{id}/

    GET /api/v1/inventory/blocks/{id}/

    Retrieve inventory blocks.

  • PUT/api/v1/inventory/blocks/{id}/

    PUT /api/v1/inventory/blocks/{id}/

    Update inventory blocks.

  • PATCH/api/v1/inventory/blocks/{id}/

    PATCH /api/v1/inventory/blocks/{id}/

    Partially update inventory blocks.

  • DELETE/api/v1/inventory/blocks/{id}/

    DELETE /api/v1/inventory/blocks/{id}/

    Delete inventory blocks.

  • GET/api/v1/inventory/rate-overrides/

    GET /api/v1/inventory/rate-overrides/

    List inventory rate overrides.

  • POST/api/v1/inventory/rate-overrides/

    POST /api/v1/inventory/rate-overrides/

    Create or perform inventory rate overrides.

  • GET/api/v1/inventory/rate-overrides/{id}/

    GET /api/v1/inventory/rate-overrides/{id}/

    Retrieve inventory rate overrides.

  • PUT/api/v1/inventory/rate-overrides/{id}/

    PUT /api/v1/inventory/rate-overrides/{id}/

    Update inventory rate overrides.

  • PATCH/api/v1/inventory/rate-overrides/{id}/

    PATCH /api/v1/inventory/rate-overrides/{id}/

    Partially update inventory rate overrides.

  • DELETE/api/v1/inventory/rate-overrides/{id}/

    DELETE /api/v1/inventory/rate-overrides/{id}/

    Delete inventory rate overrides.

  • GET/api/v1/inventory/rate-plans/

    GET /api/v1/inventory/rate-plans/

    List inventory rate plans.

  • POST/api/v1/inventory/rate-plans/

    POST /api/v1/inventory/rate-plans/

    Create or perform inventory rate plans.

  • GET/api/v1/inventory/rate-plans/{id}/

    GET /api/v1/inventory/rate-plans/{id}/

    Retrieve inventory rate plans.

  • PUT/api/v1/inventory/rate-plans/{id}/

    PUT /api/v1/inventory/rate-plans/{id}/

    Update inventory rate plans.

  • PATCH/api/v1/inventory/rate-plans/{id}/

    PATCH /api/v1/inventory/rate-plans/{id}/

    Partially update inventory rate plans.

  • DELETE/api/v1/inventory/rate-plans/{id}/

    DELETE /api/v1/inventory/rate-plans/{id}/

    Delete inventory rate plans.

  • GET/api/v1/inventory/room-types/

    GET /api/v1/inventory/room-types/

    List inventory room types.

  • POST/api/v1/inventory/room-types/

    POST /api/v1/inventory/room-types/

    Create or perform inventory room types.

  • GET/api/v1/inventory/room-types/{id}/

    GET /api/v1/inventory/room-types/{id}/

    Retrieve inventory room types.

  • PUT/api/v1/inventory/room-types/{id}/

    PUT /api/v1/inventory/room-types/{id}/

    Update inventory room types.

  • PATCH/api/v1/inventory/room-types/{id}/

    PATCH /api/v1/inventory/room-types/{id}/

    Partially update inventory room types.

  • DELETE/api/v1/inventory/room-types/{id}/

    DELETE /api/v1/inventory/room-types/{id}/

    Delete inventory room types.

  • GET/api/v1/inventory/rooms/

    GET /api/v1/inventory/rooms/

    List inventory rooms.

  • POST/api/v1/inventory/rooms/

    POST /api/v1/inventory/rooms/

    Create or perform inventory rooms.

  • GET/api/v1/inventory/rooms/{id}/

    GET /api/v1/inventory/rooms/{id}/

    Retrieve inventory rooms.

  • PUT/api/v1/inventory/rooms/{id}/

    PUT /api/v1/inventory/rooms/{id}/

    Update inventory rooms.

  • PATCH/api/v1/inventory/rooms/{id}/

    PATCH /api/v1/inventory/rooms/{id}/

    Partially update inventory rooms.

  • DELETE/api/v1/inventory/rooms/{id}/

    DELETE /api/v1/inventory/rooms/{id}/

    Delete inventory rooms.

  • GET/api/v1/notifications/

    GET /api/v1/notifications/

    List notifications.

  • GET/api/v1/notifications/{id}/

    GET /api/v1/notifications/{id}/

    Retrieve notifications.

  • POST/api/v1/notifications/{id}/read/

    POST /api/v1/notifications/{id}/read/

    Create or perform notifications read.

  • POST/api/v1/notifications/read-all/

    POST /api/v1/notifications/read-all/

    Create or perform notifications read all.

  • GET/api/v1/operations/housekeeping/

    GET /api/v1/operations/housekeeping/

    List operations housekeeping.

  • POST/api/v1/operations/housekeeping/

    POST /api/v1/operations/housekeeping/

    Create or perform operations housekeeping.

  • GET/api/v1/operations/housekeeping/{id}/

    GET /api/v1/operations/housekeeping/{id}/

    Retrieve operations housekeeping.

  • PUT/api/v1/operations/housekeeping/{id}/

    PUT /api/v1/operations/housekeeping/{id}/

    Update operations housekeeping.

  • PATCH/api/v1/operations/housekeeping/{id}/

    PATCH /api/v1/operations/housekeeping/{id}/

    Partially update operations housekeeping.

  • DELETE/api/v1/operations/housekeeping/{id}/

    DELETE /api/v1/operations/housekeeping/{id}/

    Delete operations housekeeping.

  • POST/api/v1/operations/housekeeping/{id}/complete/

    POST /api/v1/operations/housekeeping/{id}/complete/

    Create or perform operations housekeeping complete.

  • GET/api/v1/operations/maintenance/

    GET /api/v1/operations/maintenance/

    List operations maintenance.

  • POST/api/v1/operations/maintenance/

    POST /api/v1/operations/maintenance/

    Create or perform operations maintenance.

  • GET/api/v1/operations/maintenance/{id}/

    GET /api/v1/operations/maintenance/{id}/

    Retrieve operations maintenance.

  • PUT/api/v1/operations/maintenance/{id}/

    PUT /api/v1/operations/maintenance/{id}/

    Update operations maintenance.

  • PATCH/api/v1/operations/maintenance/{id}/

    PATCH /api/v1/operations/maintenance/{id}/

    Partially update operations maintenance.

  • DELETE/api/v1/operations/maintenance/{id}/

    DELETE /api/v1/operations/maintenance/{id}/

    Delete operations maintenance.

  • POST/api/v1/operations/maintenance/{id}/resolve/

    POST /api/v1/operations/maintenance/{id}/resolve/

    Create or perform operations maintenance resolve.

  • GET/api/v1/organizations/

    GET /api/v1/organizations/

    List organizations.

  • POST/api/v1/organizations/

    POST /api/v1/organizations/

    Create or perform organizations.

  • GET/api/v1/organizations/{id}/

    GET /api/v1/organizations/{id}/

    Retrieve organizations.

  • PUT/api/v1/organizations/{id}/

    PUT /api/v1/organizations/{id}/

    Update organizations.

  • PATCH/api/v1/organizations/{id}/

    PATCH /api/v1/organizations/{id}/

    Partially update organizations.

  • DELETE/api/v1/organizations/{id}/

    DELETE /api/v1/organizations/{id}/

    Delete organizations.

  • GET/api/v1/organizations/{id}/members/

    GET /api/v1/organizations/{id}/members/

    Retrieve organizations members.

  • POST/api/v1/organizations/{id}/members/

    POST /api/v1/organizations/{id}/members/

    Create or perform organizations members.

  • GET/api/v1/payments/

    GET /api/v1/payments/

    List payments.

  • POST/api/v1/payments/

    POST /api/v1/payments/

    Create or perform payments.

  • GET/api/v1/payments/{id}/

    GET /api/v1/payments/{id}/

    Retrieve payments.

  • POST/api/v1/payments/{id}/capture/

    POST /api/v1/payments/{id}/capture/

    Create or perform payments capture.

  • POST/api/v1/payments/{id}/complete/

    POST /api/v1/payments/{id}/complete/

    Create or perform payments complete.

  • POST/api/v1/payments/{id}/refund/

    POST /api/v1/payments/{id}/refund/

    Create or perform payments refund.

  • GET/api/v1/properties/

    GET /api/v1/properties/

    List properties.

  • POST/api/v1/properties/

    POST /api/v1/properties/

    Create or perform properties.

  • GET/api/v1/properties/{id}/

    GET /api/v1/properties/{id}/

    Retrieve properties.

  • PUT/api/v1/properties/{id}/

    PUT /api/v1/properties/{id}/

    Update properties.

  • PATCH/api/v1/properties/{id}/

    PATCH /api/v1/properties/{id}/

    Partially update properties.

  • DELETE/api/v1/properties/{id}/

    DELETE /api/v1/properties/{id}/

    Delete properties.

  • GET/api/v1/properties/amenities/

    GET /api/v1/properties/amenities/

    List properties amenities.

  • GET/api/v1/properties/amenities/{id}/

    GET /api/v1/properties/amenities/{id}/

    Retrieve properties amenities.

  • GET/api/v1/properties/images/

    GET /api/v1/properties/images/

    List properties images.

  • POST/api/v1/properties/images/

    POST /api/v1/properties/images/

    Create or perform properties images.

  • GET/api/v1/properties/images/{id}/

    GET /api/v1/properties/images/{id}/

    Retrieve properties images.

  • PUT/api/v1/properties/images/{id}/

    PUT /api/v1/properties/images/{id}/

    Update properties images.

  • PATCH/api/v1/properties/images/{id}/

    PATCH /api/v1/properties/images/{id}/

    Partially update properties images.

  • DELETE/api/v1/properties/images/{id}/

    DELETE /api/v1/properties/images/{id}/

    Delete properties images.

  • GET/api/v1/reviews/

    GET /api/v1/reviews/

    List reviews.

  • POST/api/v1/reviews/

    POST /api/v1/reviews/

    Create or perform reviews.

  • GET/api/v1/reviews/{id}/

    GET /api/v1/reviews/{id}/

    Retrieve reviews.

  • POST/api/v1/reviews/{id}/respond/

    POST /api/v1/reviews/{id}/respond/

    Create or perform reviews respond.

  • GET/api/v1/reviews/favorites/

    GET /api/v1/reviews/favorites/

    List reviews favorites.

  • POST/api/v1/reviews/favorites/

    POST /api/v1/reviews/favorites/

    Create or perform reviews favorites.

  • GET/api/v1/reviews/favorites/{id}/

    GET /api/v1/reviews/favorites/{id}/

    Retrieve reviews favorites.

  • DELETE/api/v1/reviews/favorites/{id}/

    DELETE /api/v1/reviews/favorites/{id}/

    Delete reviews favorites.

Frequently asked questions about Hostel Management API

What does unit_count mean?

unit_count represents sellable inventory units. For ROOM inventory it means rooms; for BED inventory it means beds. It does not represent the number of guests.

Do I need authentication?

Public discovery and availability endpoints can be used without an application JWT. Booking, payment and management operations require JWT authentication in addition to your JoJ API subscription.

Which payment providers are supported?

The API supports manual/offline payments, Paystack, Stripe, Hubtel Request Money and PayPal Orders v2. Each accommodation organization configures its own provider credentials securely.

Does the API support housekeeping and maintenance?

Yes. The operations API includes housekeeping queues, turnover tasks generated after checkout, and maintenance requests for properties, rooms and beds.

Can I manage beds as well as rooms?

Yes. Room types can use ROOM inventory or BED inventory, allowing the same API to support private rooms, dormitories and mixed hostel inventory.