Gov APIindianrail.gov.in ↗

"""Walkthrough: Indian Railways train enquiry — bounded, re-runnable."""
from parse_apis.indianrail_gov_in_api import IndianRail, InputNotFound

client = IndianRail()

# Find station codes matching a city name.
for station in client.stations.search(query="mumbai", limit=5):
    print(station.station_code, station.station_name)

# Pick the first matching station to use as destination.
dest = client.stations.search(query="mumbai", limit=1).first()
if dest is not None:
    # Search trains from Delhi (NDLS) to the discovered station.
    try:
        for train in client.trains.search(
            from_station="NDLS",
            to_station=dest.station_code,
            journey_date="2026-10-16",
            limit=3,
        ):
            print(
                train.train_number,
                train.train_name,
                train.departure_time, "→", train.arrival_time,
                f"{train.distance_km} km",
            )
            # Nested schedule shows which days the train runs.
            if train.runs_on.sat:
                print("  ^ runs on Saturday")
    except InputNotFound:
        print("station code not recognized upstream")

    # Fetch the full result wrapper for metadata alongside trains.
    result = client.train_results.fetch(
        from_station="NDLS",
        to_station=dest.station_code,
        journey_date="2026-10-16",
    )
    print(f"{result.count} trains, quota codes: {result.quota_codes}")

    # Check seat availability for the first train found.
    first_train = client.trains.search(
        from_station="NDLS",
        to_station=dest.station_code,
        journey_date="2026-10-16",
        limit=1,
    ).first()
    if first_train is not None:
        avail = client.availabilities.get(
            from_station="NDLS",
            to_station=dest.station_code,
            train_number=first_train.train_number,
            journey_date="2026-10-16",
            travel_class="3A",
        )
        print(avail.status, avail.status_kind)
        for day in (avail.availability or [])[:3]:
            print(f"  {day.date}: {day.status} (count={day.count})")

        # Get the fare breakdown for the same train.
        fare = client.fares.get(
            train_number=first_train.train_number,
            from_station="NDLS",
            to_station=dest.station_code,
            journey_date="2026-10-16",
            travel_class="3A",
        )
        print(f"Total fare: {fare.currency} {fare.total_fare} ({fare.distance_km} km)")

print("exercised: stations.search / trains.search / train_results.fetch / availabilities.get / fares.get")