For AI Agents & Developers
Mascot Car Rental API
Full booking lifecycle via public API — no API key required. Check availability, book, modify, and cancel.
API Status: Checking...
Complete public API for car rental on Kos island, Greece.
AI assistants can check real-time availability, calculate pricing, submit bookings, and manage reservations — all within a conversation.
No API key. No OAuth. No signup. Open and ready to use.
Key Policies
No deposit — ever
No credit card required
Debit cards accepted
Payment at pickup
Free cancellation 48h+
Unlimited km included
CDW insurance included
No API key needed
Discovery Endpoints
OpenAPI 3.0
Full API specification with schemas and examples
openapi.json
MCP Config
Model Context Protocol discovery for Claude and compatible agents
mcp.json
agents.json
Emerging standard for AI agent capability discovery
agents.json
A2A Protocol
Google Agent-to-Agent protocol discovery for inter-agent communication
agent.json
API Status
Health check, version, rate limits, and all discovery links
status
Booking Endpoints
GET
/api/public/vehicle-groups
List vehicle groups with live pricing. Pass start_date and end_date for date-specific rates.
GET
/api/public/availability/grouped?start_date=...&end_date=...
Check which vehicle groups have cars available for a date range.
GET
/api/public/insurance?group_code=...
List insurance tiers (CDW, SCDW, FDW) with daily rates and excess amounts per group.
GET
/api/public/extras
List extras (child seat, GPS, etc.) with pricing.
GET
/api/public/site/locations
Pickup and return locations with delivery fees.
POST
/api/public/pricing
Calculate exact rental price with seasonal multipliers, insurance, and fees.
POST
/api/public/ai/booking
Submit a booking request. Requires email verification. Set "test": true for a dry-run with a watermarked voucher.
Booking Management
GET
/api/public/ai/booking/{reference}/status?email=...
Check booking status, dates, vehicle, insurance, extras, and pricing. Email required for security.
POST
/api/public/ai/booking/{reference}/cancel
Cancel a booking. Requires email match. Staff notified via Telegram.
POST
/api/public/ai/booking/{reference}/modify
Modify dates or vehicle group. Checks availability first — suggests alternatives if unavailable.
AI Features
POST
/api/public/ai/ask
Natural language availability query. Ask "Do you have a small car for July 10-15?" and get structured results with pricing.
POST
/api/public/webhooks/subscribe
Register a webhook to receive notifications when bookings are accepted, rejected, cancelled, or modified. HMAC-SHA256 signed.
Information Endpoints
GET
/api/public/fleet-status
Live fleet snapshot: total cars, available today, popular groups, busiest upcoming days.
GET
/api/public/terms
Full terms and conditions in HTML and plain text, plus cancellation and fuel policies.
GET
/api/public/status
API health, version, capabilities list, rate limit info, and all discovery links.
Quick Start
Check availability for July 10-15:
curl https://mascotcarrental.com/api/public/availability/grouped?start_date=2026-07-10&end_date=2026-07-15
Get the fleet status right now:
curl https://mascotcarrental.com/api/public/fleet-status
Read the full AI booking guide:
curl https://mascotcarrental.com/llms.txt
Ready to integrate?
Start building with our API
