Platinumride

Finds Platinumride private transfer routes between Gulf cities. Accepts city names, IATA airport codes, Arabic names, common typos and free-text origin/destination queries. Returns indicative per-vehicle 'from' prices in local currency and approximate AED, travel time, distance, border crossings and booking links. Unmatched queries return an empty route list with suggestions.

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Free-text origin and destination query, e.g. 'DXB to Riyadh' or 'دبي إلى الرياض'.",
      "type": "string",
      "maxLength": 200
    },
    "from": {
      "description": "Origin city, airport code or Arabic name, e.g. 'Dubai', 'DXB', 'دبي'.",
      "type": "string",
      "maxLength": 100
    },
    "to": {
      "description": "Destination city, airport code or Arabic name, e.g. 'Muscat', 'MCT'.",
      "type": "string",
      "maxLength": 100
    },
    "internationalOnly": {
      "description": "Whether results are limited to routes with a border crossing.",
      "type": "boolean"
    },
    "limit": {
      "description": "Maximum number of results, from 1 to 100. Defaults to 25.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Returns the published details for one Platinumride route identified by its slug: travel time and distance as text and numbers, ordered border crossings and steps, indicative per-vehicle tier prices in local currency and approximate AED, vehicle capacities and fleet photos, inclusions, trust facts, FAQs, related routes, a matching travel guide, the Terms of Service URL and booking links.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "minLength": 1,
      "description": "Route slug, e.g. 'dubai-to-muscat-private-transfer'."
    }
  },
  "required": [
    "slug"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Sends a transfer booking inquiry to the Platinumride team. Requires a route slug, the customer's name, a WhatsApp number (E.164) or email, a travel date today or later, passenger count and agreement to the Terms of Service (https://platinumride.com/terms). Returns an inquiry reference, the indicative 'from' price for the chosen vehicle tier and a WhatsApp follow-up link. Not a confirmed booking: the team confirms availability and the final price.

{
  "type": "object",
  "properties": {
    "routeSlug": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "Route slug, e.g. 'dubai-to-riyadh-private-transfer'."
    },
    "date": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
      "description": "Travel date in YYYY-MM-DD format, today or later in UAE time."
    },
    "time": {
      "description": "Preferred pickup time, e.g. '07:30'.",
      "type": "string",
      "maxLength": 40
    },
    "passengers": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7,
      "description": "Number of passengers, 1 to 7."
    },
    "luggage": {
      "description": "Number of large suitcases.",
      "type": "integer",
      "minimum": 0,
      "maximum": 30
    },
    "vehicleTier": {
      "description": "Optional vehicle tier name available on the route, e.g. 'Premium SUV'. Matching is case-insensitive.",
      "type": "string",
      "maxLength": 60
    },
    "pickupAddress": {
      "description": "Pickup address, hotel or airport, optionally including a flight number.",
      "type": "string",
      "maxLength": 300
    },
    "dropoffAddress": {
      "description": "Drop-off address.",
      "type": "string",
      "maxLength": 300
    },
    "customerName": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "pattern": "^[^\\r\\n]+$",
      "description": "Customer's full name."
    },
    "customerWhatsApp": {
      "description": "Customer WhatsApp number in E.164 format, e.g. '+971501234567'. At least one WhatsApp number or email is required.",
      "type": "string",
      "pattern": "^\\+[1-9]\\d{6,14}$"
    },
    "customerEmail": {
      "description": "Customer email address. At least one email or WhatsApp number is required.",
      "type": "string",
      "maxLength": 255,
      "format": "email",
      "pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$"
    },
    "notes": {
      "description": "Additional trip details for the Platinumride team.",
      "type": "string",
      "maxLength": 2000
    },
    "agreedToTerms": {
      "type": "boolean",
      "description": "Whether the customer has read and agreed to the Terms of Service at https://platinumride.com/terms. Must be true."
    },
    "language": {
      "description": "Customer's preferred language for follow-up.",
      "type": "string",
      "enum": [
        "en",
        "ar"
      ]
    }
  },
  "required": [
    "routeSlug",
    "date",
    "passengers",
    "customerName",
    "agreedToTerms"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Lists Platinumride's published route travel guides with titles, cities, route slugs and page URLs. An optional guide slug returns that guide's full text, sections and FAQs covering driving time, border crossings and travel documents.

{
  "type": "object",
  "properties": {
    "slug": {
      "description": "Optional guide slug identifying the guide whose full content is returned, e.g. 'dubai-to-muscat-travel-guide'.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}