{
  "type": "object",
  "properties": {
    "situation": {
      "type": "string",
      "minLength": 3,
      "maxLength": 4000,
      "description": "What happened, in the person’s own words. For example: \"my train from Brighton to Victoria was 40 minutes late on Monday\" or \"I think my council tax band is wrong\"."
    }
  },
  "required": [
    "situation"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "from": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "Station the person got on at. A name, part of a name or a three-letter code: \"Brighton\", \"Kings Cross\", \"BTN\"."
    },
    "to": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "Station the person got off at, in the same forms."
    },
    "date": {
      "type": "string",
      "minLength": 3,
      "maxLength": 40,
      "description": "Date of travel. YYYY-MM-DD is best; \"25/09/2026\", \"25 September\", \"yesterday\" and \"last Friday\" also work."
    },
    "departure_time": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 20
        },
        {
          "type": "null"
        }
      ],
      "description": "Roughly when the train left the first station, UK time: \"08:05\", \"8am\", \"around 8\". Needed to find the train unless service_id is given."
    },
    "operator": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 60
        },
        {
          "type": "null"
        }
      ],
      "description": "Train company if known, as the person says it: \"Southern\", \"GWR\", \"Avanti\". Used to narrow the match."
    },
    "ticket_type": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 40
        },
        {
          "type": "null"
        }
      ],
      "description": "As printed: \"Anytime Return\", \"Off-Peak Single\", \"Advance\", \"Season\". A return halves the single fare the amount is worked from."
    },
    "price_paid": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 40
            },
            {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000
            }
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "What the ticket cost: \"£24.50\", 24.50 or 2450 (pence). Needed for a cash amount; without it the percentage is returned."
    },
    "service_id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 40
        },
        {
          "type": "null"
        }
      ],
      "description": "The service_id of a train listed in an earlier result. With it, that train is checked directly."
    }
  },
  "required": [
    "from",
    "to",
    "date"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "flight_number": {
      "type": "string",
      "minLength": 3,
      "maxLength": 10,
      "description": "Airline code and number, as on the booking: \"BA2551\", \"U2 8123\"."
    },
    "date": {
      "type": "string",
      "minLength": 3,
      "maxLength": 40,
      "description": "Date the flight was due to depart, local time. YYYY-MM-DD is best."
    },
    "from_airport": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 3,
          "maxLength": 3
        },
        {
          "type": "null"
        }
      ],
      "description": "Three-letter departure airport code, if known: \"LGW\". Helps pick the right flight on multi-stop numbers."
    },
    "to_airport": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 3,
          "maxLength": 3
        },
        {
          "type": "null"
        }
      ],
      "description": "Three-letter arrival airport code, if known: \"BCN\"."
    },
    "what_happened": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "delayed",
            "cancelled",
            "on_time",
            "denied_boarding"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "What happened, if known. When left out, Untap looks it up in flight-status records."
    },
    "arrival_delay_minutes": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 4320
        },
        {
          "type": "null"
        }
      ],
      "description": "How late the flight arrived at the gate, in minutes, if the person knows. Compensation turns on arrival, not departure."
    },
    "cancellation_notice_days": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 365
        },
        {
          "type": "null"
        }
      ],
      "description": "For a cancellation: how many days before departure the airline told the person. 14 or more means no compensation."
    },
    "price_paid": {
      "anyOf": [
        {
          "anyOf": [
            {
              "type": "string",
              "maxLength": 40
            },
            {
              "type": "number",
              "minimum": 0,
              "maximum": 1000000
            }
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional. Not used for the amount, which is fixed in law, but needed to save the claim to an account."
    }
  },
  "required": [
    "flight_number",
    "date"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "journeys": {
      "anyOf": [
        {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "date": {
                "type": "string",
                "description": "Journey date as YYYY-MM-DD."
              },
              "start_time": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Tap-in time as HH:MM, or null."
              },
              "end_time": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Tap-out time as HH:MM, or null."
              },
              "mode": {
                "type": "string",
                "enum": [
                  "tube",
                  "bus",
                  "overground",
                  "elizabeth",
                  "dlr",
                  "tram",
                  "cable_car",
                  "thameslink",
                  "unknown"
                ],
                "description": "Transport mode for this row, or \"unknown\" when the statement does not say."
              },
              "from_location": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Tap-in station / stop name, or null if not shown."
              },
              "to_location": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Tap-out station / stop name, or null for incomplete journeys."
              },
              "bus_route": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Bus route number for bus rows, otherwise null."
              },
              "fare_pence": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100000,
                "description": "Charge for this row in pence. £2.20 = 220."
              },
              "is_max_fare": {
                "type": "boolean",
                "description": "True if the statement labels this as a max-fare charge for a failed revenue inspection."
              },
              "is_incomplete": {
                "type": "boolean",
                "description": "True if this journey has no tap-out recorded (e.g. label \"Incomplete\" or \"No exit\")."
              },
              "is_hopper_free": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Optional. True when the statement shows this fare as a free Hopper fare (a second bus or tram within 60 minutes)."
              },
              "is_auto_corrected": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Optional. True when the statement says TfL has already corrected this journey (for example \"Auto-completed\" or \"Adjusted\")."
              },
              "is_daily_cap_hit": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Optional. True when the statement marks this row as the one where the daily cap was reached."
              },
              "is_weekly_cap_hit": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "Optional. True when the statement marks this row as the one where the weekly cap was reached."
              },
              "intended_destination": {
                "anyOf": [
                  {
                    "type": "string",
                    "maxLength": 80
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Optional, for an incomplete journey with no touch out: the station the person was travelling to. With it, the refund is estimated as the fare charged minus the usual fare to that station. Without it, the figure is an upper limit equal to the whole charge."
              }
            },
            "required": [
              "date",
              "start_time",
              "end_time",
              "mode",
              "from_location",
              "to_location",
              "bus_route",
              "fare_pence",
              "is_max_fare",
              "is_incomplete"
            ],
            "additionalProperties": false
          },
          "maxItems": 500
        },
        {
          "type": "null"
        }
      ],
      "description": "Journey rows from a TfL contactless or Oyster journey history. Used when csv_text is not given."
    },
    "csv_text": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 300000
        },
        {
          "type": "null"
        }
      ],
      "description": "The text of the CSV journey history downloaded from a TfL account. Takes priority over journeys."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "operator": {
      "type": "string",
      "minLength": 2,
      "maxLength": 60,
      "description": "Train company name as people say it: \"Avanti\", \"GWR\", \"Southern\", \"LNER\", or a two-letter operator code."
    }
  },
  "required": [
    "operator"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "claim_type": {
      "type": "string",
      "enum": [
        "train_delay",
        "train_cancellation",
        "flight_delay",
        "flight_cancellation",
        "denied_boarding",
        "tfl_incomplete_journey",
        "tfl_overcharge"
      ],
      "description": "What the claim is for: a late or cancelled train, a delayed or cancelled flight, denied boarding, a TfL incomplete journey or another TfL overcharge."
    },
    "company": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 2,
          "maxLength": 80
        },
        {
          "type": "null"
        }
      ],
      "description": "The train operator or airline, by name or code as people say it: \"Southern\", \"LNER\", \"easyJet\", \"BA\", \"U2\". Not needed for TfL."
    },
    "journey_date": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 40
        },
        {
          "type": "null"
        }
      ],
      "description": "Date of travel, YYYY-MM-DD. With it, the result gives the last day to claim as a date."
    },
    "ticket_type": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 40
        },
        {
          "type": "null"
        }
      ],
      "description": "Ticket type as printed, such as \"Anytime Return\", \"Advance Single\" or \"Season\". Decides the rail return-ticket rule."
    },
    "booked_via": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "operator_direct",
            "third_party_retailer",
            "travel_agent",
            "package_holiday"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Where the ticket was bought: from the operator or airline itself, from a ticket retailer such as Trainline, through a travel agent, or as part of a package holiday."
    },
    "departure_airport": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 3,
          "maxLength": 3
        },
        {
          "type": "null"
        }
      ],
      "description": "Three-letter departure airport code, such as \"CDG\". Decides whether UK261 or EU261 applies, and with the arrival airport, the distance band."
    },
    "arrival_airport": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 3,
          "maxLength": 3
        },
        {
          "type": "null"
        }
      ],
      "description": "Three-letter arrival airport code, such as \"LHR\"."
    }
  },
  "required": [
    "claim_type"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "emails": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "from": {
            "type": "string",
            "maxLength": 500,
            "description": "The From line as received, such as \"Trainline <auto-confirm@info.thetrainline.com>\"."
          },
          "subject": {
            "type": "string",
            "maxLength": 1000,
            "description": "The subject line."
          },
          "date": {
            "type": "string",
            "maxLength": 100,
            "description": "When the email was sent: ISO 8601 or the raw Date header."
          },
          "body_text": {
            "type": "string",
            "maxLength": 200000,
            "description": "The plain-text body. Only the first 20,000 characters are read."
          }
        },
        "required": [
          "from",
          "subject",
          "date",
          "body_text"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 25,
      "description": "Up to 25 emails, each with its sender, subject, date and plain-text body."
    }
  },
  "required": [
    "emails"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "enum": [
        "train",
        "flight",
        "tfl"
      ],
      "description": "Which kind of check the claim came from."
    },
    "train": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "ticket_price_pence": {
              "type": "integer",
              "minimum": 1,
              "maximum": 1000000,
              "description": "Total fare paid in pence for the whole booking. £62.00 = 6200."
            },
            "ticket_type": {
              "type": "string",
              "enum": [
                "single",
                "return",
                "open_return",
                "advance",
                "anytime",
                "off_peak",
                "super_off_peak",
                "season",
                "other"
              ],
              "description": "Ticket type as printed. For \"return\" and \"open_return\" the single fare is half the price paid; every other type uses the full price as the single fare."
            },
            "booking_reference": {
              "type": [
                "string",
                "null"
              ],
              "description": "Booking reference if available, otherwise null."
            },
            "legs": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "operator_toc_code": {
                    "type": "string",
                    "enum": [
                      "VT",
                      "CC",
                      "CH",
                      "EM",
                      "GX",
                      "GN",
                      "GW",
                      "LE",
                      "NT",
                      "SW",
                      "SE",
                      "SN",
                      "TL",
                      "TP",
                      "AW",
                      "LM",
                      "LN",
                      "XC",
                      "GR",
                      "SR",
                      "LD",
                      "HT",
                      "CS"
                    ],
                    "description": "National Rail two-letter operator code for this journey: VT=Avanti West Coast, CC=c2c, CH=Chiltern Railways, EM=East Midlands Railway, GX=Gatwick Express, GN=Great Northern, GW=Great Western Railway, LE=Greater Anglia, NT=Northern Trains, SW=South Western Railway, SE=Southeastern, SN=Southern, TL=Thameslink, TP=TransPennine Express, AW=Transport for Wales, LM=West Midlands Railway, LN=London Northwestern Railway, XC=CrossCountry, GR=LNER, SR=ScotRail, LD=Lumo, HT=Hull Trains, CS=Caledonian Sleeper"
                  },
                  "departure_station": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Full departure station name, e.g. \"London Kings Cross\"."
                  },
                  "arrival_station": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Full arrival station name, e.g. \"Edinburgh Waverley\"."
                  },
                  "scheduled_departure": {
                    "type": "string",
                    "description": "Scheduled departure as ISO 8601 datetime."
                  },
                  "scheduled_arrival": {
                    "type": "string",
                    "description": "Scheduled arrival as ISO 8601 datetime."
                  },
                  "delay_minutes": {
                    "anyOf": [
                      {
                        "type": "integer",
                        "minimum": 0,
                        "maximum": 1440
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Optional. Delay at arrival for this journey, in minutes, if known. When left out, Untap looks it up in National Rail records."
                  },
                  "actual_arrival": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Optional. Actual arrival for this journey as an ISO 8601 datetime, if known. When left out, Untap looks it up."
                  },
                  "was_cancelled": {
                    "type": [
                      "boolean",
                      "null"
                    ],
                    "description": "Optional. True when this journey was cancelled. When set, no National Rail lookup is made."
                  }
                },
                "required": [
                  "operator_toc_code",
                  "departure_station",
                  "arrival_station",
                  "scheduled_departure",
                  "scheduled_arrival"
                ],
                "additionalProperties": false
              },
              "minItems": 1,
              "maxItems": 8,
              "description": "Each journey on this booking, in travel order: one for a single, two for a return (outward first), more for a multi-stop booking. Untap works out Delay Repay for each journey and adds them up."
            }
          },
          "required": [
            "ticket_price_pence",
            "ticket_type",
            "booking_reference",
            "legs"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "For category \"train\": the train booking, in the shape a train check returns in save_claim.arguments.train, with ticket_price_pence set."
    },
    "flight": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "airline_iata": {
              "type": "string",
              "minLength": 2,
              "maxLength": 2,
              "description": "Two-letter IATA airline code, e.g. \"BA\" for British Airways, \"U2\" for easyJet."
            },
            "flight_number": {
              "type": "string",
              "description": "Flight number including the airline prefix, e.g. \"BA2551\"."
            },
            "departure_iata": {
              "type": "string",
              "minLength": 3,
              "maxLength": 3,
              "description": "Three-letter IATA departure airport code, e.g. \"LHR\"."
            },
            "arrival_iata": {
              "type": "string",
              "minLength": 3,
              "maxLength": 3,
              "description": "Three-letter IATA arrival airport code, e.g. \"BCN\"."
            },
            "scheduled_departure": {
              "type": "string",
              "description": "Scheduled departure as ISO 8601 datetime."
            },
            "scheduled_arrival": {
              "type": "string",
              "description": "Scheduled arrival as ISO 8601 datetime."
            },
            "ticket_price_pence": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50000000,
              "description": "Total fare paid in pence."
            },
            "booking_reference": {
              "type": [
                "string",
                "null"
              ],
              "description": "PNR / airline booking reference if available, otherwise null."
            },
            "passenger_name": {
              "type": [
                "string",
                "null"
              ],
              "description": "Passenger name as printed on the ticket, or null if not visible."
            },
            "status": {
              "anyOf": [
                {
                  "type": "string",
                  "enum": [
                    "on_time",
                    "delayed",
                    "cancelled",
                    "denied_boarding"
                  ]
                },
                {
                  "type": "null"
                }
              ],
              "description": "Optional. What happened to the flight, if known. When left out, Untap looks the flight up in AeroDataBox flight-status records."
            },
            "actual_arrival": {
              "type": [
                "string",
                "null"
              ],
              "description": "Optional. Actual arrival as an ISO 8601 datetime, if known."
            },
            "delay_minutes": {
              "anyOf": [
                {
                  "type": "integer",
                  "minimum": 0,
                  "maximum": 2880
                },
                {
                  "type": "null"
                }
              ],
              "description": "Optional. Arrival delay in minutes, if known."
            }
          },
          "required": [
            "airline_iata",
            "flight_number",
            "departure_iata",
            "arrival_iata",
            "scheduled_departure",
            "scheduled_arrival",
            "ticket_price_pence",
            "booking_reference",
            "passenger_name"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "For category \"flight\": the flight, in the shape a flight check returns in save_claim.arguments.flight, with ticket_price_pence set."
    },
    "tfl": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "card_last4": {
              "type": [
                "string",
                "null"
              ],
              "description": "Last 4 digits of the contactless card, if shown."
            },
            "period_start": {
              "type": [
                "string",
                "null"
              ],
              "description": "Statement period start date YYYY-MM-DD."
            },
            "period_end": {
              "type": [
                "string",
                "null"
              ],
              "description": "Statement period end date YYYY-MM-DD."
            },
            "journeys": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "date": {
                    "type": "string",
                    "description": "Journey date as YYYY-MM-DD."
                  },
                  "start_time": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Tap-in time as HH:MM, or null."
                  },
                  "end_time": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Tap-out time as HH:MM, or null."
                  },
                  "mode": {
                    "type": "string",
                    "enum": [
                      "tube",
                      "bus",
                      "overground",
                      "elizabeth",
                      "dlr",
                      "tram",
                      "cable_car",
                      "thameslink",
                      "unknown"
                    ],
                    "description": "Transport mode for this row, or \"unknown\" when the statement does not say."
                  },
                  "from_location": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Tap-in station / stop name, or null if not shown."
                  },
                  "to_location": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Tap-out station / stop name, or null for incomplete journeys."
                  },
                  "bus_route": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "description": "Bus route number for bus rows, otherwise null."
                  },
                  "fare_pence": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 100000,
                    "description": "Charge for this row in pence. £2.20 = 220."
                  },
                  "is_max_fare": {
                    "type": "boolean",
                    "description": "True if the statement labels this as a max-fare charge for a failed revenue inspection."
                  },
                  "is_incomplete": {
                    "type": "boolean",
                    "description": "True if this journey has no tap-out recorded (e.g. label \"Incomplete\" or \"No exit\")."
                  },
                  "is_hopper_free": {
                    "type": [
                      "boolean",
                      "null"
                    ],
                    "description": "Optional. True when the statement shows this fare as a free Hopper fare (a second bus or tram within 60 minutes)."
                  },
                  "is_auto_corrected": {
                    "type": [
                      "boolean",
                      "null"
                    ],
                    "description": "Optional. True when the statement says TfL has already corrected this journey (for example \"Auto-completed\" or \"Adjusted\")."
                  },
                  "is_daily_cap_hit": {
                    "type": [
                      "boolean",
                      "null"
                    ],
                    "description": "Optional. True when the statement marks this row as the one where the daily cap was reached."
                  },
                  "is_weekly_cap_hit": {
                    "type": [
                      "boolean",
                      "null"
                    ],
                    "description": "Optional. True when the statement marks this row as the one where the weekly cap was reached."
                  },
                  "intended_destination": {
                    "anyOf": [
                      {
                        "type": "string",
                        "maxLength": 80
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Optional, for an incomplete journey with no touch out: the station the person was travelling to. With it, the refund is estimated as the fare charged minus the usual fare to that station. Without it, the figure is an upper limit equal to the whole charge."
                  }
                },
                "required": [
                  "date",
                  "start_time",
                  "end_time",
                  "mode",
                  "from_location",
                  "to_location",
                  "bus_route",
                  "fare_pence",
                  "is_max_fare",
                  "is_incomplete"
                ],
                "additionalProperties": false
              },
              "minItems": 1,
              "maxItems": 500,
              "description": "Every journey on the statement. Up to 500 per call."
            }
          },
          "required": [
            "card_last4",
            "period_start",
            "period_end",
            "journeys"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "For category \"tfl\": the journeys, in the shape a TfL check returns in save_claim.arguments.tfl."
    }
  },
  "required": [
    "category"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "commute_id": {
      "anyOf": [
        {
          "type": "string",
          "format": "uuid"
        },
        {
          "type": "null"
        }
      ],
      "description": "The id of an existing commute in this account, to update or restore it. When left out, a new route is saved."
    },
    "label": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 100
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional short name such as Morning commute."
    },
    "from": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "Departure station name or three-letter code."
    },
    "to": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "Arrival station name or three-letter code."
    },
    "departure_time": {
      "type": "string",
      "minLength": 1,
      "maxLength": 20,
      "description": "Usual UK departure time, for example 08:05 or 8am."
    },
    "weekdays": {
      "type": "array",
      "items": {
        "type": "integer",
        "minimum": 1,
        "maximum": 7
      },
      "minItems": 1,
      "maxItems": 7,
      "default": [
        1,
        2,
        3,
        4,
        5
      ],
      "description": "Usual travel days: Monday=1 through Sunday=7. Informational only; no automatic checks."
    },
    "ticket_type": {
      "type": "string",
      "enum": [
        "single",
        "return"
      ],
      "default": "single",
      "description": "Day ticket type. For return, the price is the whole return fare. Season tickets are not supported by saved commutes."
    },
    "ticket_price_pence": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "maximum": 1000000
        },
        {
          "type": "null"
        }
      ],
      "description": "Usual day-ticket price in pence, £24.50=2450. Optional, for when the fare is known and stays the same. A day-ticket price, not a weekly or monthly season price."
    }
  },
  "required": [
    "from",
    "to",
    "departure_time"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "include_stopped": {
      "type": "boolean",
      "default": false,
      "description": "Include stopped routes so they can be restored."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "commute_id": {
      "type": "string",
      "format": "uuid",
      "description": "The id of a saved commute. The route is kept and can be restored."
    }
  },
  "required": [
    "commute_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "commute_id": {
      "type": "string",
      "format": "uuid",
      "description": "The id of a saved commute."
    },
    "date": {
      "type": "string",
      "minLength": 3,
      "maxLength": 40,
      "description": "The travel date to check, preferably YYYY-MM-DD. \"yesterday\" also works."
    },
    "service_id": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 40
        },
        {
          "type": "null"
        }
      ],
      "description": "The service_id of a train listed in an earlier result. With it, that train is checked directly."
    }
  },
  "required": [
    "commute_id",
    "date"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "category": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "train",
            "flight",
            "tfl",
            "parking"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Restricts the list to one category. When left out, all categories are listed."
    },
    "include_closed": {
      "type": "boolean",
      "default": false,
      "description": "Also show claims marked paid, rejected or archived, and ones with nothing to claim."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25,
      "description": "Most rows to return. Defaults to 25."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "claim_id": {
      "type": "string",
      "format": "uuid",
      "description": "The claim_id given when the claim was saved or listed."
    },
    "status": {
      "type": "string",
      "enum": [
        "sent",
        "paid",
        "rejected",
        "archived"
      ],
      "description": "sent: submitted to the operator or airline. paid: money received. rejected: the claim was refused. archived: hide it without an outcome."
    },
    "amount_received_pence": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 10000000
        },
        {
          "type": "null"
        }
      ],
      "description": "For paid: the amount actually received, in pence. £12.40 = 1240."
    },
    "note": {
      "anyOf": [
        {
          "type": "string",
          "maxLength": 500
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional short note, such as the operator’s reference or the reason given for a refusal."
    }
  },
  "required": [
    "claim_id",
    "status"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "ticket_price_pence": {
      "type": "integer",
      "minimum": 1,
      "maximum": 1000000,
      "description": "Total fare paid in pence for the whole booking. £62.00 = 6200."
    },
    "ticket_type": {
      "type": "string",
      "enum": [
        "single",
        "return",
        "open_return",
        "advance",
        "anytime",
        "off_peak",
        "super_off_peak",
        "season",
        "other"
      ],
      "description": "Ticket type as printed. For \"return\" and \"open_return\" the single fare is half the price paid; every other type uses the full price as the single fare."
    },
    "booking_reference": {
      "type": [
        "string",
        "null"
      ],
      "description": "Booking reference if available, otherwise null."
    },
    "legs": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "operator_toc_code": {
            "type": "string",
            "enum": [
              "VT",
              "CC",
              "CH",
              "EM",
              "GX",
              "GN",
              "GW",
              "LE",
              "NT",
              "SW",
              "SE",
              "SN",
              "TL",
              "TP",
              "AW",
              "LM",
              "LN",
              "XC",
              "GR",
              "SR",
              "LD",
              "HT",
              "CS"
            ],
            "description": "National Rail two-letter operator code for this journey: VT=Avanti West Coast, CC=c2c, CH=Chiltern Railways, EM=East Midlands Railway, GX=Gatwick Express, GN=Great Northern, GW=Great Western Railway, LE=Greater Anglia, NT=Northern Trains, SW=South Western Railway, SE=Southeastern, SN=Southern, TL=Thameslink, TP=TransPennine Express, AW=Transport for Wales, LM=West Midlands Railway, LN=London Northwestern Railway, XC=CrossCountry, GR=LNER, SR=ScotRail, LD=Lumo, HT=Hull Trains, CS=Caledonian Sleeper"
          },
          "departure_station": {
            "type": "string",
            "minLength": 1,
            "description": "Full departure station name, e.g. \"London Kings Cross\"."
          },
          "arrival_station": {
            "type": "string",
            "minLength": 1,
            "description": "Full arrival station name, e.g. \"Edinburgh Waverley\"."
          },
          "scheduled_departure": {
            "type": "string",
            "description": "Scheduled departure as ISO 8601 datetime."
          },
          "scheduled_arrival": {
            "type": "string",
            "description": "Scheduled arrival as ISO 8601 datetime."
          },
          "delay_minutes": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0,
                "maximum": 1440
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional. Delay at arrival for this journey, in minutes, if known. When left out, Untap looks it up in National Rail records."
          },
          "actual_arrival": {
            "type": [
              "string",
              "null"
            ],
            "description": "Optional. Actual arrival for this journey as an ISO 8601 datetime, if known. When left out, Untap looks it up."
          },
          "was_cancelled": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Optional. True when this journey was cancelled. When set, no National Rail lookup is made."
          }
        },
        "required": [
          "operator_toc_code",
          "departure_station",
          "arrival_station",
          "scheduled_departure",
          "scheduled_arrival"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 8,
      "description": "Each journey on this booking, in travel order: one for a single, two for a return (outward first), more for a multi-stop booking. Untap works out Delay Repay for each journey and adds them up."
    }
  },
  "required": [
    "ticket_price_pence",
    "ticket_type",
    "booking_reference",
    "legs"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "airline_iata": {
      "type": "string",
      "minLength": 2,
      "maxLength": 2,
      "description": "Two-letter IATA airline code, e.g. \"BA\" for British Airways, \"U2\" for easyJet."
    },
    "flight_number": {
      "type": "string",
      "description": "Flight number including the airline prefix, e.g. \"BA2551\"."
    },
    "departure_iata": {
      "type": "string",
      "minLength": 3,
      "maxLength": 3,
      "description": "Three-letter IATA departure airport code, e.g. \"LHR\"."
    },
    "arrival_iata": {
      "type": "string",
      "minLength": 3,
      "maxLength": 3,
      "description": "Three-letter IATA arrival airport code, e.g. \"BCN\"."
    },
    "scheduled_departure": {
      "type": "string",
      "description": "Scheduled departure as ISO 8601 datetime."
    },
    "scheduled_arrival": {
      "type": "string",
      "description": "Scheduled arrival as ISO 8601 datetime."
    },
    "ticket_price_pence": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50000000,
      "description": "Total fare paid in pence."
    },
    "booking_reference": {
      "type": [
        "string",
        "null"
      ],
      "description": "PNR / airline booking reference if available, otherwise null."
    },
    "passenger_name": {
      "type": [
        "string",
        "null"
      ],
      "description": "Passenger name as printed on the ticket, or null if not visible."
    },
    "status": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "on_time",
            "delayed",
            "cancelled",
            "denied_boarding"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional. What happened to the flight, if known. When left out, Untap looks the flight up in AeroDataBox flight-status records."
    },
    "actual_arrival": {
      "type": [
        "string",
        "null"
      ],
      "description": "Optional. Actual arrival as an ISO 8601 datetime, if known."
    },
    "delay_minutes": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 2880
        },
        {
          "type": "null"
        }
      ],
      "description": "Optional. Arrival delay in minutes, if known."
    }
  },
  "required": [
    "airline_iata",
    "flight_number",
    "departure_iata",
    "arrival_iata",
    "scheduled_departure",
    "scheduled_arrival",
    "ticket_price_pence",
    "booking_reference",
    "passenger_name"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "card_last4": {
      "type": [
        "string",
        "null"
      ],
      "description": "Last 4 digits of the contactless card, if shown."
    },
    "period_start": {
      "type": [
        "string",
        "null"
      ],
      "description": "Statement period start date YYYY-MM-DD."
    },
    "period_end": {
      "type": [
        "string",
        "null"
      ],
      "description": "Statement period end date YYYY-MM-DD."
    },
    "journeys": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "description": "Journey date as YYYY-MM-DD."
          },
          "start_time": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tap-in time as HH:MM, or null."
          },
          "end_time": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tap-out time as HH:MM, or null."
          },
          "mode": {
            "type": "string",
            "enum": [
              "tube",
              "bus",
              "overground",
              "elizabeth",
              "dlr",
              "tram",
              "cable_car",
              "thameslink",
              "unknown"
            ],
            "description": "Transport mode for this row, or \"unknown\" when the statement does not say."
          },
          "from_location": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tap-in station / stop name, or null if not shown."
          },
          "to_location": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tap-out station / stop name, or null for incomplete journeys."
          },
          "bus_route": {
            "type": [
              "string",
              "null"
            ],
            "description": "Bus route number for bus rows, otherwise null."
          },
          "fare_pence": {
            "type": "integer",
            "minimum": 0,
            "maximum": 100000,
            "description": "Charge for this row in pence. £2.20 = 220."
          },
          "is_max_fare": {
            "type": "boolean",
            "description": "True if the statement labels this as a max-fare charge for a failed revenue inspection."
          },
          "is_incomplete": {
            "type": "boolean",
            "description": "True if this journey has no tap-out recorded (e.g. label \"Incomplete\" or \"No exit\")."
          },
          "is_hopper_free": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Optional. True when the statement shows this fare as a free Hopper fare (a second bus or tram within 60 minutes)."
          },
          "is_auto_corrected": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Optional. True when the statement says TfL has already corrected this journey (for example \"Auto-completed\" or \"Adjusted\")."
          },
          "is_daily_cap_hit": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Optional. True when the statement marks this row as the one where the daily cap was reached."
          },
          "is_weekly_cap_hit": {
            "type": [
              "boolean",
              "null"
            ],
            "description": "Optional. True when the statement marks this row as the one where the weekly cap was reached."
          },
          "intended_destination": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 80
              },
              {
                "type": "null"
              }
            ],
            "description": "Optional, for an incomplete journey with no touch out: the station the person was travelling to. With it, the refund is estimated as the fare charged minus the usual fare to that station. Without it, the figure is an upper limit equal to the whole charge."
          }
        },
        "required": [
          "date",
          "start_time",
          "end_time",
          "mode",
          "from_location",
          "to_location",
          "bus_route",
          "fare_pence",
          "is_max_fare",
          "is_incomplete"
        ],
        "additionalProperties": false
      },
      "minItems": 1,
      "maxItems": 500,
      "description": "Every journey on the statement. Up to 500 per call."
    }
  },
  "required": [
    "card_last4",
    "period_start",
    "period_end",
    "journeys"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "pcn_reference": {
      "type": "string",
      "description": "PCN or notice reference number printed on the document."
    },
    "issuer_type": {
      "type": "string",
      "enum": [
        "council",
        "private"
      ],
      "description": "Council = local authority issued under TMA 2004. Private = on private land by a parking operator (BPA or IPC member)."
    },
    "issuer_name": {
      "type": "string",
      "description": "Issuer name as written, e.g. \"London Borough of Camden\" or \"ParkingEye Ltd\"."
    },
    "contravention_code": {
      "type": [
        "string",
        "null"
      ],
      "description": "Council contravention code, e.g. \"01\", \"12\", \"MR11\". Null for private tickets."
    },
    "contravention_description": {
      "type": "string",
      "description": "Full text of the alleged contravention as printed on the notice."
    },
    "vehicle_registration": {
      "type": [
        "string",
        "null"
      ],
      "description": "Vehicle registration mark, or null if not shown."
    },
    "location": {
      "type": "string",
      "description": "Street or car park name where the contravention allegedly occurred."
    },
    "contravention_date": {
      "type": "string",
      "description": "Date the contravention allegedly occurred, ISO 8601 date."
    },
    "issued_date": {
      "type": "string",
      "description": "Date the notice was issued or served, ISO 8601 date."
    },
    "amount_pence": {
      "type": "integer",
      "minimum": 1,
      "description": "Full charge amount in pence. £65 = 6500."
    },
    "discounted_amount_pence": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "description": "Reduced amount in pence if paid promptly (usually 50% within 14 or 21 days). Null if none stated."
    },
    "discount_deadline": {
      "type": [
        "string",
        "null"
      ],
      "description": "ISO date by which the discount applies, or null if not stated."
    },
    "full_deadline": {
      "type": [
        "string",
        "null"
      ],
      "description": "Last date on the notice for paying the full amount or lodging an appeal, as an ISO date."
    },
    "appeal_url": {
      "anyOf": [
        {
          "type": "string",
          "format": "uri",
          "pattern": "^https\\:\\/\\/"
        },
        {
          "type": "null"
        }
      ],
      "description": "Direct https URL on the notice for online appeals, or null if none."
    },
    "has_windscreen_notice": {
      "type": "boolean",
      "description": "True if a paper notice was placed on the windscreen. False if it arrived in the post only."
    },
    "keeper_notice_served_date": {
      "type": [
        "string",
        "null"
      ],
      "description": "Private only: date the Notice to Keeper was served."
    },
    "observed_notes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Short phrases from the notice or the person’s account that may support an appeal, such as unclear signs, a broken machine or a few minutes over. The appeal-grounds engine matches against these; with none, it can only suggest general grounds."
    }
  },
  "required": [
    "pcn_reference",
    "issuer_type",
    "issuer_name",
    "contravention_code",
    "contravention_description",
    "vehicle_registration",
    "location",
    "contravention_date",
    "issued_date",
    "amount_pence",
    "discounted_amount_pence",
    "discount_deadline",
    "full_deadline",
    "appeal_url",
    "has_windscreen_notice",
    "keeper_notice_served_date",
    "observed_notes"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "category": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "train",
            "flight",
            "tfl",
            "parking"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Restrict to a single category, or null for all categories."
    },
    "status": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "claimable",
            "pending_check",
            "not_eligible",
            "submitted",
            "received",
            "expired"
          ]
        },
        {
          "type": "null"
        }
      ],
      "description": "Restrict to a single status, or null for all."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "default": 25,
      "description": "Maximum number of savings rows to return. Defaults to 25, capped at 100."
    }
  },
  "required": [
    "category",
    "status"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "confirm": {
      "type": "boolean",
      "default": false,
      "description": "false returns a preview of what would be deleted and a confirmation_token, and deletes nothing. true deletes, and works only with an unexpired confirmation_token from a preview."
    },
    "confirmation_token": {
      "type": [
        "string",
        "null"
      ],
      "default": null,
      "description": "The confirmation_token from a preview. Required when confirm is true; each token works once."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}