RegTail

When a UK plate of this format could have been issued, from the plate alone (format, age identifier, and the window as first and last month). Offline: it does not look the car up; use free_check for that. No account needed.

{
  "type": "object",
  "properties": {
    "plate": {
      "description": "UK registration plate, any spacing or case, e.g. 'AB12 CDE'",
      "title": "Plate",
      "type": "string"
    }
  },
  "required": [
    "plate"
  ],
  "title": "decode_plate_appArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "decode_plate_appDictOutput"
}

The free check of a UK car by its registration plate: make, model, engine and fuel, tax and MOT status with their dates, and the latest MOT test with its result, mileage and any defects or advisories. Use when the user gives a plate or asks about a car. Have an advert? Read its number plate from its photos and send that; advert links are not accepted. No account needed and nothing is spent. Returns: car, tax, mot, latest_mot_test, since_previous_test, unlocked (whether the user's linked account can already see the full report), full_report_covers (what the full report adds) and guidance.

{
  "type": "object",
  "properties": {
    "plate": {
      "description": "UK registration plate, any spacing or case, e.g. 'AB12 CDE'",
      "title": "Plate",
      "type": "string"
    }
  },
  "required": [
    "plate"
  ],
  "title": "free_checkArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "free_checkDictOutput"
}

The full report and viewing advice for one public sample car (CX52HHM, a 2002 Land Rover Defender), to show what a full report contains. Use when the user asks what RegTail's full report looks like. No account needed. It is always the same sample car, never the user's car.

{
  "type": "object",
  "properties": {},
  "title": "sample_reportArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "sample_reportDictOutput"
}

The full report of a car the user has unlocked on their RegTail account: verdict and top risks, every MOT test with defects and advisories, mileage analysis, recurring advisories, other sections, the viewing checklist, what was not checked, and guidance for explaining it. Use to discuss a car in depth. Needs the user's RegTail account linked. Never spends: for a plate that is not unlocked it returns unlocked=false and a message; then ask the user before calling unlock_report.

{
  "type": "object",
  "properties": {
    "plate": {
      "description": "UK registration plate, any spacing or case, e.g. 'AB12 CDE'",
      "title": "Plate",
      "type": "string"
    }
  },
  "required": [
    "plate"
  ],
  "title": "full_reportArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "full_reportDictOutput"
}

Spends one of the user's RegTail credits to unlock the full report for this plate for 30 days, then returns the full report (as full_report does). Ask the user first, every time, and call this only after they agree; never unlock on your own initiative or to answer a general question. A plate already unlocked costs nothing again. Needs the user's RegTail account linked. With no credits left it unlocks nothing and spends nothing.

{
  "type": "object",
  "properties": {
    "plate": {
      "description": "UK registration plate, any spacing or case, e.g. 'AB12 CDE'",
      "title": "Plate",
      "type": "string"
    },
    "confirmed": {
      "description": "True only when the user has just said yes to spending one credit on this plate",
      "title": "Confirmed",
      "type": "boolean"
    }
  },
  "required": [
    "plate",
    "confirmed"
  ],
  "title": "unlock_reportArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "unlock_reportDictOutput"
}

Advice for viewing an unlocked car in person: a summary, priorities to check (each with why and the report records behind it) and known weak spots of the model. Needs the user's RegTail account linked and the plate unlocked; never spends.

{
  "type": "object",
  "properties": {
    "plate": {
      "description": "UK registration plate, any spacing or case, e.g. 'AB12 CDE'",
      "title": "Plate",
      "type": "string"
    }
  },
  "required": [
    "plate"
  ],
  "title": "viewing_advice_appArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "viewing_advice_appDictOutput"
}

How many credits the user's RegTail account holds, and pricing_url, a page explaining how credits work. Needs the user's RegTail account linked.

{
  "type": "object",
  "properties": {},
  "title": "credits_balance_appArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "credits_balance_appDictOutput"
}

The cars the user has unlocked (with when each unlock ends) and their recent checks, so a conversation can pick up a car checked earlier. Needs the user's RegTail account linked.

{
  "type": "object",
  "properties": {},
  "title": "my_reportsArguments"
}

{
  "type": "object",
  "additionalProperties": true,
  "title": "my_reportsDictOutput"
}