API

Inputs and outputs for flights, hotels, cabs, and hostels. A key works only after an admin verifies the account.

Access

Send Authorization: Bearer <api key> with every call. Keys are issued only after an admin verifies the account. Responses are sample prices in INR.

POST

Flights

/api/v1/flights

Lowest sample fares for a city pair. Prices are in INR and cannot be ticketed.

Field	Type	Required	Detail
from	string	Yes	Departure airport code, such as DEL.
to	string	Yes	Arrival airport code, such as BOM.
depart	string	Yes	Departure date, YYYY-MM-DD, today or later.
returnDate	string	No	Return date for a return trip. Omit for one way.
trip	oneway \| return \| multi	No	Defaults to return when returnDate is set, otherwise oneway.
adults	number	No	Travelers aged 12+. Defaults to 1.
children	number	No	Travelers aged 2–11. Defaults to 0.
cabin	economy \| premium \| business	No	Defaults to economy.
directOnly	boolean	No	When true, only nonstop sample fares are returned.

Input

{
  "from": "DEL",
  "to": "BOM",
  "depart": "2026-10-18",
  "returnDate": "2026-10-25",
  "trip": "return",
  "adults": 1,
  "children": 0,
  "cabin": "economy",
  "directOnly": false
}

Output

{
  "tool": "flights",
  "sample": true,
  "currency": "INR",
  "query": {
    "from": "DEL",
    "to": "BOM",
    "depart": "2026-10-18",
    "returnDate": "2026-10-25",
    "trip": "return",
    "cabin": "economy"
  },
  "results": [
    {
      "id": "6E214-6E318",
      "airline": "IndiGo",
      "flightNumber": "6E214",
      "from": "DEL",
      "to": "BOM",
      "departAt": "2026-10-18T02:15:00.000Z",
      "arriveAt": "2026-10-18T04:30:00.000Z",
      "durationMinutes": 135,
      "stops": 0,
      "price": 7420,
      "cabin": "economy",
      "baggage": "7 kg cabin · 15 kg check-in",
      "return": {
        "airline": "IndiGo",
        "flightNumber": "6E318",
        "from": "BOM",
        "to": "DEL",
        "departAt": "2026-10-25T08:40:00.000Z",
        "arriveAt": "2026-10-25T11:00:00.000Z",
        "durationMinutes": 140,
        "stops": 0
      }
    }
  ]
}

POST

Hotels

/api/v1/hotels

Sample rooms in a city. The price is per night in INR and cannot be reserved.

Field	Type	Required	Detail
city	string	Yes	City airport code, such as GOI or DEL.
checkIn	string	Yes	Check-in date, YYYY-MM-DD.
checkOut	string	Yes	Check-out date, on or after check-in.
guests	number	No	Number of guests. Defaults to 2.

Input

{
  "city": "GOI",
  "checkIn": "2026-10-18",
  "checkOut": "2026-10-20",
  "guests": 2
}

Output

{
  "tool": "hotels",
  "sample": true,
  "currency": "INR",
  "query": {
    "city": "GOI",
    "checkIn": "2026-10-18",
    "checkOut": "2026-10-20",
    "guests": 2,
    "nights": 2
  },
  "results": [
    {
      "id": "GOI-0-Palolem House",
      "name": "Palolem House",
      "city": "GOI",
      "detail": "Canacona · Beach view · Breakfast",
      "price": 6400,
      "unit": "per night",
      "freeCancel": true
    }
  ]
}

POST

Cabs

/api/v1/cabs

Sample rides from a pickup city. The price is per ride in INR and cannot be booked.

Field	Type	Required	Detail
pickup	string	Yes	Pickup airport code, such as DEL.
drop	string	Yes	Drop airport code. Must differ from pickup.
date	string	Yes	Ride date, YYYY-MM-DD.
passengers	number	No	Defaults to 1.

Input

{
  "pickup": "DEL",
  "drop": "BOM",
  "date": "2026-10-18",
  "passengers": 2
}

Output

{
  "tool": "cabs",
  "sample": true,
  "currency": "INR",
  "query": {
    "pickup": "DEL",
    "drop": "BOM",
    "date": "2026-10-18",
    "passengers": 2
  },
  "results": [
    {
      "id": "DEL-0-Sedan",
      "name": "Sedan",
      "city": "DEL",
      "detail": "4 seats · 2 bags · Airport or city",
      "price": 1490,
      "unit": "per ride",
      "freeCancel": true
    }
  ]
}

POST

Hostels

/api/v1/hostels

Sample beds in a city. The price is per bed in INR and cannot be reserved.

Field	Type	Required	Detail
city	string	Yes	City airport code, such as GOI.
checkIn	string	Yes	Check-in date, YYYY-MM-DD.
checkOut	string	Yes	Check-out date, on or after check-in.
beds	number	No	Number of beds. Defaults to 1.

Input

{
  "city": "GOI",
  "checkIn": "2026-10-18",
  "checkOut": "2026-10-20",
  "beds": 1
}

Output

{
  "tool": "hostels",
  "sample": true,
  "currency": "INR",
  "query": {
    "city": "GOI",
    "checkIn": "2026-10-18",
    "checkOut": "2026-10-20",
    "beds": 1,
    "nights": 2
  },
  "results": [
    {
      "id": "GOI-0-Anjuna Dorms",
      "name": "Anjuna Dorms",
      "city": "GOI",
      "detail": "6-bed dorm · Lockers · Common kitchen",
      "price": 799,
      "unit": "per bed",
      "freeCancel": true
    }
  ]
}