Untap
UK refunds inside your AI assistant: train delays, flights, TfL, parking. Made in London.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"untap-mcp": {
"url": "https://untap.money/api/mcp"
}
}
}원격 엔드포인트
https://untap.money/api/mcpstreamable-http할 수 있는 일
도구 목록
도구 (18)
🟢find_money_owed(situation)
Takes a plain-language description of what happened (a late or cancelled train, a delayed or cancelled flight, a TfL overcharge, a parking ticket, a council tax, water or broadband problem) and returns the UK refund and compensation schemes Untap covers that may apply. For each one it gives the fact that decides it, the Untap check that covers it and Untap’s free guide. It also picks out any flight number, date, time or amount in the text. Matching is by keywords, not a full reading of the situation, so the list is a starting point rather than a verdict. No sign-in needed. Journey details are not saved to an account; limited usage metadata is recorded.
입력 스키마
{
"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#"
}🟢check_train_delay(from, to, date, departure_time, operator, ...)
Checks a late or cancelled train in Great Britain against National Rail’s historic running records and works out Delay Repay. Takes the two stations (names, partial names or three-letter codes), the date and roughly when the train left; the operator, ticket type and price paid are optional. Returns the matched train with scheduled and actual times, the delay at the destination, the operator and its scheme, the amount (or the percentage when no price is given), the claim deadline, a claim pack with the value for each form field, and the details needed to save the claim to an Untap account. When several trains fit, the result lists them, each with a service_id. The records cover roughly the last year and each day appears the day after. They hold direct trains only, so a journey with a change is checked one train at a time. No sign-in needed. Journey details are not saved to an account; limited usage metadata is recorded.
입력 스키마
{
"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#"
}🟢check_flight_compensation(flight_number, date, from_airport, to_airport, what_happened, ...)
Works out compensation for a delayed or cancelled flight under UK261 or EU261. Takes the flight number and date. What happened comes from flight-status records, which cover about the last year, or from what_happened and arrival_delay_minutes when given. Returns the matched route, the arrival delay, the distance band, the amount per passenger, the extraordinary-circumstances caveat, the airline’s claim page, the dispute body for a refused claim, deadline guidance, a claim pack and the details needed to save the claim to an Untap account. When the airports given differ from the flight-status record, the result says so. No sign-in needed. Journey details are not saved to an account; limited usage metadata is recorded.
입력 스키마
{
"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#"
}🟢check_tfl_journeys(journeys, csv_text)
Checks Transport for London contactless or Oyster journeys for overcharges: incomplete journeys (no touch out, so the maximum fare was charged) and missed Hopper fares. Takes journey rows from a journey history, or the text of the CSV download from a TfL account. PDFs and images are not accepted. TfL refunds an incomplete journey as the maximum fare minus the fare for the journey actually made. Without the destination, the refund shown is an upper limit equal to the whole charge; with intended_destination on the row, it is an estimate from the usual fare to that station. Returns the refundable journeys and total, older journeys outside TfL’s 8 week window, how to claim in the TfL account, a claim pack and the details needed to save the journeys to an Untap account. No sign-in needed. Journey details are not saved to an account; limited usage metadata is recorded.
입력 스키마
{
"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#"
}🟢get_delay_repay_rules(operator)
Returns one train operator’s Delay Repay rules: the delay at which it starts paying, each payout tier, the claim deadline, the link to its claim form, any automatic or one-click scheme, and the date the rules were last checked against the operator’s own page. Accepts the operator’s name as people say it, such as Avanti, GWR or Southern. No sign-in needed.
입력 스키마
{
"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#"
}🟡save_claim(category, train, flight, tfl)
Saves the result of a train, flight or TfL check to the person’s Untap account, so it appears on their dashboard with its deadline. Accepts the save_claim arguments returned by a check, with the price paid added where the check listed it as missing. The verdict is worked out again from those facts rather than copied. A train journey that is already saved is returned as it is, not saved twice. Requires sign-in to Untap.
입력 스키마
{
"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#"
}🟡save_commute(commute_id, label, from, to, departure_time, ...)
Saves or updates one direction of a usual train journey (a commute) in the person’s Untap account: stations, usual departure time, travel days and day-ticket fare. An outward and a homeward journey are two separate routes. Saving the same route and time again updates it. Nothing is checked automatically; a saved route is checked only on request. Day tickets only; season tickets are not supported. Requires sign-in to Untap.
입력 스키마
{
"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#"
}🟢list_commutes(include_stopped)
Lists the person’s saved train routes with their ids, usual times, days and fares. Makes no National Rail lookups. Requires sign-in to Untap.
입력 스키마
{
"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#"
}⚪stop_commute(commute_id)
Hides a saved train route from the active list. The route is kept and can be restored by saving it again with its commute_id. No claims or bookings change. Requires sign-in to Untap.
입력 스키마
{
"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#"
}🟢check_commute(commute_id, date, service_id)
Checks a saved train route against National Rail’s running records for one travel date and works out Delay Repay: the matched train, the delay, the amount, the deadline and a claim pack. When several trains match, the result lists them, each with a service_id. A saved route does not show that the person travelled that day, and the result says so. Nothing is saved or filed. Requires sign-in to Untap.
입력 스키마
{
"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#"
}🟢list_my_claims(category, include_closed, limit)
Lists the claims in the person’s Untap account with amounts, deadlines, the verdict and their progress (not sent, sent, paid, rejected or archived). By default it shows claims that are still open; include_closed adds paid, rejected and archived ones. Requires sign-in to Untap.
입력 스키마
{
"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#"
}🟡update_claim_status(claim_id, status, amount_received_pence, note)
Records progress on a claim in the person’s Untap account: sent (submitted to the operator or airline), paid (with the amount received, if known), rejected, or archived. Takes the claim_id given when the claim was saved or listed. This updates Untap’s record only; it does not contact the operator or airline. Requires sign-in to Untap.
입력 스키마
{
"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#"
}🟡add_train_journey(ticket_price_pence, ticket_type, booking_reference, legs)
Adds a UK train booking to the person’s Untap account and works out Delay Repay for it. One booking per call, with each journey in legs (one for a single, two for a return, in travel order). Untap checks National Rail’s Historical Service Performance records for each journey; the delay, actual arrival and cancellation fields are optional, and when left out Untap looks them up. Operators accept one journey per claim form, so a return with both directions late means two claims. A train journey that is already saved is returned as it is, not saved twice. Requires sign-in to Untap.
입력 스키마
{
"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#"
}🟡add_flight(airline_iata, flight_number, departure_iata, arrival_iata, scheduled_departure, ...)
Adds a flight to the person’s Untap account and returns the UK261 or EU261 verdict, the amount and the airline’s claim link. For past flights Untap checks AeroDataBox flight-status records; the status, delay and actual arrival fields are optional, and when left out Untap looks them up. Takes the airline’s two-letter IATA code (BA, U2, FR) and three-letter airport codes (LHR, BCN). When the airports given differ from the flight-status record, the result says so. Compensation applies to arrival delays of 3 hours or more and to cancellations. Requires sign-in to Untap.
입력 스키마
{
"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#"
}🟡add_tfl_journeys(card_last4, period_start, period_end, journeys)
Adds TfL contactless journeys to the person’s Untap account, up to 500 rows per call, and checks everything they have saved for incomplete journeys, missed Hopper fares and other overcharges. Each row carries flags for an incomplete journey, a revenue-inspection maximum fare, a free Hopper fare, a TfL correction and the daily or weekly cap, as shown on the statement. Journeys already saved are skipped. Refunds follow the same rule as the TfL check: an incomplete journey without a destination is an upper limit equal to the whole charge, and one with intended_destination is an estimate. Requires sign-in to Untap.
입력 스키마
{
"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#"
}🟡add_parking_fine(pcn_reference, issuer_type, issuer_name, contravention_code, contravention_description, ...)
Adds a UK parking ticket (a council PCN or a private parking charge) to the person’s Untap account and runs Untap’s appeal-grounds engine. Returns the grounds that may apply, how confident the match is, the appeal route and deadline. Grounds are matched against the contravention, the location and observed_notes; with no observed_notes, only general grounds come back and the result is a possible appeal, not money owed. Requires sign-in to Untap.
입력 스키마
{
"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#"
}🟢list_savings(category, status, limit)
Lists the savings rows in the person’s Untap account, filtered by category and status. Each row has the verdict status (claimable, pending_check, not_eligible and so on) and user_progress, what the person has recorded since: none, submitted (sent), received (paid) or archived. Requires sign-in to Untap.
입력 스키마
{
"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#"
}🔴delete_my_data(confirm, confirmation_token)
Deletes every booking, statement, saved commute and claim in the person’s Untap account, in two steps. A call with confirm=false deletes nothing and returns a summary of what would be deleted, with a confirmation_token valid for 5 minutes. A call with confirm=true and that token deletes the data permanently; each token works once. The account itself is kept so Untap can still be used; deleting the account too is done at untap.money/data. Requires sign-in to Untap.
입력 스키마
{
"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#"
}커뮤니티
증거