{"components":{"schemas":{"Vehicle":{"properties":{"availability_checked_at":{"format":"date-time","type":["string","null"]},"availability_fresh":{"type":"boolean"},"availability_note":{"type":"string"},"availability_review_state":{"enum":["unverified","expired","current"]},"availability_valid_until":{"format":"date-time","type":["string","null"]},"available_from":{"description":"Estimated next available date YYYY-MM-DD, or empty when unknown.","type":"string"},"billing_basis":{"enum":["unknown","calendar_month","30_days"]},"billing_period":{"const":"month"},"blocked_ranges":{"description":"Start inclusive, end exclusive; no customer information. If review is stale, ranges require reconfirmation.","items":{"properties":{"end":{"format":"date","type":"string"},"start":{"format":"date","type":"string"}},"required":["start","end"],"type":"object"},"type":"array"},"body":{"type":"string"},"brand":{"type":"string"},"cities":{"items":{"enum":["cancun","playa-del-carmen","tulum"],"type":"string"},"type":"array"},"color":{"type":"string"},"contact_url":{"format":"uri","type":"string"},"currency":{"const":"MXN"},"deductible_mxn":{"minimum":0,"type":["integer","null"]},"delivery_included":{"type":"boolean"},"deposit_mxn":{"minimum":0,"type":["integer","null"]},"deposit_note":{"type":["string","null"]},"deposit_return_days":{"minimum":0,"type":["integer","null"]},"description":{"type":"string"},"discount_minimum_months":{"const":3},"engine_l":{"type":"number"},"id":{"type":"string"},"images":{"items":{"format":"uri","type":"string"},"type":"array"},"insurance_included":{"type":["boolean","null"]},"liability_included":{"type":"boolean"},"maintenance_included":{"type":"boolean"},"mileage_km":{"description":"Monthly allowance; null means unlimited.","type":["integer","null"]},"minimum_driver_age":{"minimum":0,"type":["integer","null"]},"minimum_months":{"const":1},"model":{"type":"string"},"monthly_mxn":{"minimum":1,"type":"integer"},"name":{"type":"string"},"provider":{"enum":["own","partner"],"type":"string"},"provider_name":{"type":"string"},"rental_conditions":{"additionalProperties":{"type":"string"},"type":"object"},"seats":{"type":"integer"},"status":{"description":"General inventory status. available is subject to confirmation for requested dates; reserved means currently rented; request means unknown.","enum":["available","reserved","request"],"type":"string"},"tax_note":{"type":"string"},"tax_status":{"enum":["unknown","included","excluded"]},"terms_checked_at":{"format":"date-time","type":["string","null"]},"three_month_mxn":{"minimum":1,"type":["integer","null"]},"transmission":{"type":"string"},"updated":{"format":"date-time","type":"string"},"url":{"format":"uri","type":"string"},"year":{"type":"integer"}},"required":["id","name","url","currency","monthly_mxn","minimum_months","status","updated"],"type":"object"}}},"info":{"description":"Read-only public monthly rental offers in Quintana Roo, Mexico. Prices are in MXN per month, not per day. Minimum commitment is one month; three_month_mxn applies to a minimum three-month commitment. This API does not reserve, charge, or guarantee availability for specific dates. A null deposit means not specified, never zero. null mileage_km means unlimited as stated on the listing. Tax treatment and coverage must be confirmed in writing. Availability is only current until availability_valid_until; an unverified or expired record returns status=request. Editing content does not renew the availability check. billing_basis distinguishes calendar_month, 30_days and unknown.","title":"Automensual public rental inventory","version":"1.1.0"},"openapi":"3.1.0","paths":{"/api/v1/vehicles":{"get":{"operationId":"listMonthlyRentalVehicles","parameters":[{"in":"query","name":"lang","schema":{"default":"en","enum":["es","en"],"type":"string"}},{"in":"query","name":"city","schema":{"enum":["cancun","playa-del-carmen","tulum"],"type":"string"}},{"in":"query","name":"status","schema":{"enum":["available","reserved","request"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"count":{"type":"integer"},"currency":{"const":"MXN"},"vehicles":{"items":{"$ref":"#/components/schemas/Vehicle"},"type":"array"}},"required":["currency","count","vehicles"],"type":"object"}}},"description":"Published inventory, including unavailable cars with explicit status"},"400":{"description":"Unsupported filter value"}},"summary":"Read published cars and rental rates"}},"/api/v1/vehicles/{id}":{"get":{"operationId":"getMonthlyRentalVehicle","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"query","name":"lang","schema":{"default":"en","enum":["es","en"],"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Vehicle"}}},"description":"Vehicle and rental conditions"},"400":{"description":"Unsupported language"},"404":{"description":"Unknown or unpublished vehicle"}},"summary":"Read one published vehicle"}},"/api/v1/vehicles/{id}/availability":{"get":{"operationId":"checkRecordedRentalDates","parameters":[{"in":"path","name":"id","required":true,"schema":{"type":"string"}},{"in":"query","name":"start","required":true,"schema":{"format":"date","type":"string"}},{"in":"query","name":"end","required":true,"schema":{"format":"date","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"properties":{"result":{"enum":["unavailable","needs_confirmation","potentially_available"]}},"type":"object"}}},"description":"Result is unavailable, needs_confirmation, or potentially_available. No result guarantees a booking."},"400":{"description":"Invalid dates"},"404":{"description":"Unknown or unpublished car"}},"summary":"Check recorded dates without making a reservation"}}},"servers":[{"url":"https://automensual.mx"}]}