API and agent documentation

Markdown from any page

Every public page serves markdown from its normal URL when you ask for it with an Accept header. Browsers get HTML, agents get markdown, and both responses vary on Accept so a cache can never hand you the wrong one.

curl -H 'Accept: text/markdown' https://www.maisonmileend.ca/en/rooms

Same URL, no separate documentation site.

Public API

Live availability and all-in pricing for a stay, taxes and fees included. This is the only unauthenticated endpoint we publish.

GET https://www.maisonmileend.ca/api/v1/booking/availability?arrival=2026-09-12&departure=2026-09-15&adults=2&children=0

No API key and no authentication. Dates use the YYYY-MM-DD format, and departure must be after arrival.

Start at /api for the JSON index, or /.well-known/api-catalog if you would rather discover it the standard way.

Rate limit: 40 requests per 60 seconds per client. Over that the endpoint returns 429.

Every response carries RateLimit-Limit, RateLimit-Remaining, RateLimit-Reset and RateLimit-Policy — not only the refusal — so you can pace yourself. A 429 adds Retry-After.

Errors

Every error, including a wrong URL anywhere under /api, is JSON in one envelope: code, status, message, an optional hint and details, plus documentation_url. Branch on code, never on the prose. There are no HTML error pages.

Versioning and deprecation

The major version is in the path (/api/v1), and every response carries API-Version. Inside a major version only additive changes ship. Anything breaking becomes a new major version, and the retired one keeps answering for at least 180 days with Deprecation, Sunset and a Link to its successor.

Machine-readable resources

• /api/mcp

  Model Context Protocol server — connect an assistant and call availability and property facts as tools.

• /api

  JSON index of the public API: endpoints, limits, error codes, versioning.

• /deprecation-policy.md

  How the API is versioned and how a retirement is announced.

• /.well-known/api-catalog

  RFC 9727 catalog linking the OpenAPI spec and the agent instructions.

• /llms.txt

  Index of this site for language models, in the llmstxt.org format.

• /llms-full.txt

  Every public page of the site as markdown, in one file.

• /agents.md

  When to use this property, how to call it, and what it cannot do.

• /openapi.json

  OpenAPI 3.1 description of the public availability endpoint.

• /sitemap.xml

  Every indexable URL, in both languages, with hreflang alternates.

• /robots.txt

  Crawl rules and the paths that require a credential.

Reach a human

Anything an agent cannot settle — a special request, a group enquiry, an existing reservation — goes to the hosts directly.

• +1-514-700-3932
• info@maisonmileend.ca