Hey Humsafar

Hey Humsafar for developers and AI agents

Read-only JSON for AI agents and developers: the same answers our rail tools give, keyless for low volume. Every answer carries checkedAt and source; a failure is an error, never a guess.

Endpoints

trains_between

GET https://heyhumsafar.com/api/humsafar/public/trains?from=Delhi&to=Jaipur&date=2026-10-05

Every train between two cities for a date (6 h cache).

train

GET https://heyhumsafar.com/api/humsafar/public/train/12015

A train's timetable with every halt.

booking_dates

GET https://heyhumsafar.com/api/humsafar/public/booking-dates?date=2026-12-20

When general and Tatkal booking open for a journey date.

refund_calculator

GET https://heyhumsafar.com/api/humsafar/public/refund?fare=1500&pax=2&cls=3A&state=CNF&hoursLeft=30

The IRCTC cancellation refund, from the published slabs.

confirm_chance

GET https://heyhumsafar.com/api/humsafar/public/chance?status=GNWL%2045&cls=3A&daysLeft=12

Our waitlist confirmation estimate, with its basis.

station_board and pnr_status

Not in the keyless API: live station boards and PNR lookups cost a provider call each and a PNR is personal. Use /station and /pnr in a browser; in browsers that support WebMCP, those tools are offered to your agent with your consent.

Documented

Limits and terms

  • 30 requests a minute per IP (limits as of ). Heavier use: write to us.
  • Read-only. No personal data is accepted or returned.
  • Attribute “Hey Humsafar” and link the page the answer came from.
  • Answers change: always show checkedAt to your user.

The same description for machines is at /llms.txt.