Developer Portal

The Palais Unterkunft API provides programmatic access to hotel information and booking inquiries. No authentication required. All endpoints return JSON.

OpenAPI Spec (openapi.json) · AI Plugin Manifest · MCP Server Card

Base URL

https://palais-unterkunft.de/api

Authentication

No authentication required. All endpoints are publicly accessible. Rate limit: 60 requests per minute per IP.

Endpoints

GET/api/hotel

Returns complete hotel information including address, contact, amenities, check-in/out times and rating.

curl https://palais-unterkunft.de/api/hotel
{
  "name": "Palais Unterkunft",
  "type": "Hotel",
  "address": { "street": "Futterstraße 13", "city": "Erfurt", "postalCode": "99084" },
  "contact": { "phone": "+4936155060606", "email": "info@palais-erfurt.de" },
  "checkin": "15:00",
  "checkout": "10:00",
  "rooms": 13,
  "rating": { "value": 4.7, "count": 575 }
}

GET/api/rooms

Returns all room types with capacity, pricing guidance and amenities.

curl https://palais-unterkunft.de/api/rooms
{
  "rooms": [
    { "type": "Einzelzimmer", "persons": 1, "price_from": 67 },
    { "type": "Doppelzimmer", "persons": 2, "price_from": null },
    { "type": "Dreibettzimmer", "persons": 3, "price_from": null },
    { "type": "Suite", "persons": 2, "accessible": true }
  ],
  "note": "Prices vary by date. Contact hotel for current rates."
}

POST/api/inquiry

Submit a booking inquiry. Hotel responds within 24 hours by email.

curl -X POST https://palais-unterkunft.de/api/inquiry \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Max Mustermann",
    "email": "max@example.com",
    "checkin": "2026-06-01",
    "checkout": "2026-06-03",
    "guests": 2,
    "message": "Doppelzimmer mit Blick auf Altstadt gewünscht"
  }'
{ "success": true, "message": "Inquiry submitted. We will contact you within 24 hours." }

For AI Agents

When to use this API:

Workflow: Call GET /api/hotel for property info, GET /api/rooms for room types, then POST /api/inquiry with user details to initiate booking.

Note: Real-time availability is not available via API. The inquiry endpoint sends a request directly to the hotel who responds within 24 hours.

Resources