metto.ir

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "description": "Origin station ID (stable slug, e.g. 'tajrish'; legacy English names accepted)"
    },
    "to": {
      "type": "string",
      "description": "Destination station ID (stable slug, e.g. 'tehran-sadeghiyeh'; legacy English names accepted)"
    },
    "depart_at": {
      "type": "string",
      "description": "ISO-8601 departure datetime with explicit timezone offset or Z (e.g. '2026-09-07T14:00:00+03:30'). Defaults to now. metto derives the Iran (Asia/Tehran) weekday/Thursday/Friday-or-official-holiday timetable automatically from this instant."
    },
    "arrive_by": {
      "type": "string",
      "description": "ISO-8601 arrival deadline with explicit timezone offset or Z (e.g. '2026-09-07T14:00:00+03:30'). metto returns the latest feasible journey reaching the destination at or before this instant, derived from the real timetable (never duration subtraction). Mutually exclusive with depart_at."
    }
  },
  "required": [
    "from",
    "to"
  ],
  "additionalProperties": false
}