Intercity buses on a date: company, terminal, times, price per seat, free seats, bus type, stops, refund penalties.

A city id covers all its terminals. price_toman is per seat. Top-level refund_penalties apply to every bus unless a bus lists its own (until_hours_before: step applies until then, null = up to departure). Next: mb_bus_seats with a bus_id; other days: mb_bus_price_calendar.

Cheapest bus seat per day for a route; days without buses (or not on sale yet) are left out.

Then mb_search_buses for the chosen day.

Seat map of one bus: free seat numbers, seats sold to women and to men, and a row-by-row layout.

layout: one line per row from the front; seat = number + mark (none free, w woman, m man, x not sold online); '|' aisle, '--' no seat, 'DR' driver. price_toman is null for most buses: use the search price.

Private door-to-door intercity taxis (whole car, up to 3 passengers) for a date, one offer per pick-up slot.

price_toman is for the whole car. Many city pairs have no taxis (e.g. Tehran-Mashhad).

Turn a city, airport, station or hotel name into the code a search takes.

flight: airports (Iranian IATA codes; Tehran is THR; prefer to XXXALL for domestic routes) and cities (any country; XXXALL = all its airports). train: station ids. bus / taxi: 8-digit city ids (11320000 = Tehran, all terminals). hotel: city and hotel slugs.

List airlines (IATA code), rail operators or bus companies (id) with Persian and English names.

Use to name a code seen in results or to find a code for the airlines filter. Bus ids 276/278/280 are the taxi classes VIP/Economy/Formal.

Notices MrBilit currently shows on its pages (disruptions, rule changes, payment options), for a service or route.

Route codes build the site path the notices match (/flights/THR-MHD, /trains/tehran-mashhad, /hotel/mashhad). site_wide_active counts every active notice. Use before recommending a trip.

Search MrBilit's official rules, FAQ and help-center guides; returns the best matching passages.

Use for refund, cancellation, ID and baggage rules. Rules of one fare are in mb_flight_fare_details / mb_search_trains / mb_search_buses instead.

MrBilit's guide for a route or city (summary, FAQ, article) and matching travel-magazine posts.

Route guide: service + origin + destination (flight IATA codes, train/bus English slugs such as 'tehran'; hotel: destination city slug only). Magazine: query. Quoted prices can be out of date.

Search flights for a date: every bookable flight with price, seats left, baggage and times.

price_toman is one adult's fare (taxes included); total_toman the whole party. Domestic round trips come back as two lists (outbound, return); international ones as packages priced for both ways. Unpriced flights are only counted in not_on_sale. Next: mb_flight_fare_details with the flight_id; to pick the day first, mb_flight_price_calendar.

Cheapest one-adult fare per day for a route over a date range, in one call.

Then call mb_search_flights for the chosen day. Values are cached minimums and can differ from a live search; days with no known fare are left out.

Every fare of one flight with refund penalties, confirmed baggage, fare rules, notes and per-passenger prices.

Re-runs the mb_search_flights search (same route, date, party). refund_penalties: penalty percent per window before departure, refund = paid x (100 - penalty_pct) / 100.

Hotels and stays with a free room in a city for the dates, with the cheapest room price for the whole stay.

price_toman is the cheapest room for all nights (one room, after discount); cheapest_room_sleeps is how many that room sleeps (often 1). Guest count does not change prices: pick a fitting room with mb_hotel_rooms(guests=...). Next: mb_hotel, mb_hotel_rooms, mb_hotel_calendar.

One hotel: stars, guest rating (0-5) and latest reviews, location, landmarks, check-in rules, amenities, FAQ.

landmarks: distance in km (drive minutes). Review text is cut at 400 characters unless full_text. hotel is null after a numeric id: get the 'city/hotel' ref from mb_find_place(mode='hotel'). Prices: mb_hotel_rooms, mb_hotel_calendar.

Every room of a hotel with its exact price for the dates: whole stay, per night, rooms left, meals.

price_toman is the whole stay for one room after discount (independent of guest count: choose rooms whose sleeps fits). rooms_left 0 = full. Empty rooms = nothing free (try mb_hotel_calendar).

Cheapest one-night room price per night from today, up to about 48 days (often fewer).

Then mb_hotel_rooms for exact prices. Nights missing inside the range have no free room; nights after the last one are not loaded yet.

Every listed hotel of a city, sold out ones included, with stars, rating and address; no prices.

Filters apply to one page of 90 hotels at a time, so check pages. Prices: mb_search_hotels or mb_hotel_calendar.

Trains between two stations on a date with every class (wagon), its price per adult and free seats.

price_toman is per adult; for children, infants or a compartment call mb_train_price with the class_id. Top-level refund_penalties apply to every class unless it lists its own. Stops: mb_train_stops. No seats: mb_train_price_calendar or mb_alternative_routes. A round trip is two calls (return leg with outbound_class_id).

Cheapest train ticket per day (one adult) for a route, only days with free seats.

Then mb_search_trains for the chosen day. Sales open about 18 days ahead.

Exact price of one train class for a party: per adult, child, infant, foreigner and empty berth, and the total.

A sold-out class still returns a price: check seats_left in the search first. The breakdown does not add up exactly to the price; the price is what is paid.

Every station a train stops at, in order, with the date and local time at each.

Takes a class_id, never a train number. The first stop can be before your station.

Alternatives when direct trains are full or dear: trips with one change, and nearby train, bus and flight routes.

with_one_change: up to 7 journeys with one change, any mix of train and bus (price per adult). nearby_*: routes near the two stations with the cheapest price where known (classes_listed is a raw count, not bookable classes); pass their ids to mb_search_trains, mb_search_buses or mb_search_flights. Seat counts here can be cached: confirm with a search.