API Documentation

    Complete reference documentation for integrating Maku.travel APIs into your applications.

    API Reference

    Search APIs

    Hotels, flights, and activities search endpoints with real-time data.

    GET /v1/hotels/searchGET /v1/flights/searchGET /v1/activities/search

    Booking APIs

    Create, manage, and cancel bookings programmatically.

    POST /v1/bookingsGET /v1/bookings/{id}PUT /v1/bookings/{id}

    Location APIs

    Geographic data, destinations, and location-based services.

    GET /v1/locationsGET /v1/destinationsGET /v1/geocode

    Authentication

    Secure API access with OAuth 2.0 and API key management.

    POST /v1/auth/tokenGET /v1/auth/verifyPOST /v1/auth/refresh

    Webhooks

    Real-time notifications for booking updates and events.

    POST /v1/webhooksGET /v1/webhooksDELETE /v1/webhooks/{id}

    User Management

    User profiles, preferences, and account management.

    GET /v1/users/profilePUT /v1/users/profileGET /v1/users/bookings

    Quick Start Guide

    1

    Get Your API Key

    Sign up for a developer account and generate your API key from the dashboard.

    curl -X POST https://api.maku.travel/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "dev@example.com", "password": "password"}'
    2

    Make Your First Request

    Test the API with a simple hotel search request.

    curl -X GET "https://api.maku.travel/v1/hotels/search?destination=Sydney&checkin=2025-06-01&checkout=2025-06-05" \
  -H "Authorization: Bearer YOUR_API_KEY"
    3

    Handle the Response

    Process the JSON response and integrate the data into your application.

    {
  "results": [
    {
      "id": "hotel_123",
      "name": "Sydney Harbor Hotel",
      "price": 250,
      "currency": "AUD",
      "rating": 4.5
    }
  ]
}