Travel Itinerary API Documentation

Rules:

• Dates should be in YYYY-MM-DD format only.

API Overview:

This API generates a travel itinerary with budget allocation based on user-provided parameters.

Endpoint:

Parameters:

• destination: Destination city/country (string)
• start_date: Trip start date (YYYY-MM-DD)
• end_date: Trip end date (YYYY-MM-DD)
• number_of_people: Number of travelers (integer)
• purpose: Trip purpose (vacation/business/pilgrimage) (string)
• budget: Total trip budget (float)
• location: Current location of travelers (string)
• mode_of_transport: Preferred transport mode (string)

Response:

The response is a JSON object containing the itinerary and budget allocation.

Example Response:

{
  "trip_summary": {
    "from": "Mumbai",
    "to": "Goa",
    "travel_dates": [
      "2025-04-01",
      "2025-04-10"
    ],
    "total_budget": 20000,
    "currency": "INR"
  },
  "transport": {
    "selected": "flight",
    "options": [
      {
        "mode": "flight",
        "cost": 8000,
        "duration": "1h30m"
      }
    ]
  },
  "budget": {
    "transport": 8000,
    "accommodation": 6000,
    "activities": 4000,
    "food": 4000,
    "contingency": 2000,
    "remaining": 0
  },
  "itinerary": [
    {
      "day": 1,
      "date": "2025-04-01",
      "activities": [
        "Beach exploration",
        "Museum",
        "Waterfall"
      ],
      "transport_used": "taxi"
    },
    {
      "day": 2,
      "date": "2025-04-02",
      "activities": [
        "Beach volleyball",
        "Snorkeling",
        "Dinner at a local restaurant"
      ],
      "transport_used": "bus"
    }
  ]
}