{
  "manifestVersion": "1.0.0",
  "name": "ALMAVERA Delivery Programmatic Service",
  "description": "API Manifest for AI Agents to programmatically query shipping rates and book door-to-door courier services between Miami and Orlando.",
  "serviceType": "Same-Day & Next-Day Package Delivery",
  "routes": {
    "MiamiToOrlando": {
      "origin": "Miami, FL",
      "destination": "Orlando, FL",
      "transitTime": "5 hours door-to-door"
    },
    "OrlandoToMiami": {
      "origin": "Orlando, FL",
      "destination": "Miami, FL",
      "transitTime": "5 hours door-to-door"
    }
  },
  "pricingRules": {
    "currency": "USD",
    "basePrice": 50.00,
    "description": "Delivery starts at $50.00 USD. Final price varies depending on the total weight and volume of the package."
  },
  "api": {
    "bookingEndpoint": "/api/booking",
    "method": "POST",
    "requestContentType": "application/json",
    "payloadSchema": {
      "type": "object",
      "properties": {
        "senderName": {
          "type": "string",
          "description": "Full name of the sender."
        },
        "senderPhone": {
          "type": "string",
          "description": "Contact telephone number of the sender."
        },
        "senderEmail": {
          "type": "string",
          "format": "email",
          "description": "Email of the sender for invoices and tracking."
        },
        "originAddress": {
          "type": "string",
          "description": "Full pickup address in the origin city."
        },
        "originZip": {
          "type": "string",
          "description": "Zip code of the pickup address (must be valid for Miami/Orlando areas)."
        },
        "receiverName": {
          "type": "string",
          "description": "Full name of the recipient."
        },
        "receiverPhone": {
          "type": "string",
          "description": "Contact telephone number of the recipient."
        },
        "destinationAddress": {
          "type": "string",
          "description": "Full delivery address in the destination city."
        },
        "destinationZip": {
          "type": "string",
          "description": "Zip code of the delivery address."
        },
        "route": {
          "type": "string",
          "enum": ["Miami-Orlando", "Orlando-Miami"],
          "description": "The delivery route direction."
        },
        "packageWeight": {
          "type": "number",
          "minimum": 0.1,
          "description": "Weight of the package in the specified unit."
        },
        "packageUnit": {
          "type": "string",
          "enum": ["Lbs", "Kgs"],
          "default": "Lbs",
          "description": "The unit of weight. Must be 'Lbs' (Pounds) or 'Kgs' (Kilograms)."
        },
        "packageDescription": {
          "type": "string",
          "description": "Brief description of the items being shipped (e.g., 'Urgent documents', 'Extra luggage')."
        },
        "scheduledDate": {
          "type": "string",
          "format": "date",
          "description": "YYYY-MM-DD format. Date when the package should be dispatched."
        }
      },
      "required": [
        "senderName",
        "senderPhone",
        "senderEmail",
        "originAddress",
        "originZip",
        "receiverName",
        "receiverPhone",
        "destinationAddress",
        "destinationZip",
        "route",
        "packageWeight",
        "scheduledDate"
      ]
    },
    "responseSchema": {
      "type": "object",
      "properties": {
        "status": {
          "type": "string",
          "example": "success"
        },
        "bookingId": {
          "type": "string",
          "example": "AV-2026-98741"
        },
        "trackingNumber": {
          "type": "string",
          "example": "TRK-AV-592837"
        },
        "price": {
          "type": "number",
          "example": 42.50
        },
        "message": {
          "type": "string",
          "example": "Booking successfully created. Pickup scheduled."
        }
      }
    }
  }
}