# Auth.md

Nothing on this site's machine-readable surface requires authentication. Human-readable API
documentation lives at `/docs`.

## Public, no credentials

All of the following return `200` to any client, with no API key, token, cookie or OAuth flow:

| Endpoint | Content |
|---|---|
| `GET /api/v1/agency` | agency identity, contact details, service area |
| `GET /api/v1/properties` | published property listings, paginated and filterable |
| `GET /api/v1/properties/{slug}` | one listing |
| `GET /api/v1/categories` | property categories |
| `GET /api/v1/services` | services offered |
| `GET /api/v1/posts` | articles, newest first |
| `GET /api/v1/pages` | static pages |
| `POST /mcp` | MCP server, JSON-RPC 2.0 |
| `GET /openapi.json` | OpenAPI 3.1 description |
| `GET /llm-info.json` | agency summary for agents |
| `GET /llms.txt` | site index for language models |

## Rate limits

60 requests per minute per IP. Every response carries:

- `RateLimit-Limit` — requests allowed in the window
- `RateLimit-Remaining` — requests left
- `RateLimit-Policy` — `60;w=60`

A `429` response also carries `Retry-After`, and `RateLimit-Reset` mirrors it. Back off for the
number of seconds given, then retry.

## What does not exist

There are no write endpoints and no accounts. This API cannot book a viewing, send an enquiry,
create a listing or accept a payment. To contact the agency, use the details from
`GET /api/v1/agency`; the contact form on the website is the only way to send a message.

## Errors

Errors are returned as `application/problem+json` (RFC 9457) with `type`, `title`, `status`,
`detail` and `instance`. Validation failures add an `errors` object keyed by field name.

## Deprecation

The surface is versioned at `/api/v1`. Breaking changes are published under a new version.
Operations being removed carry the `Deprecation` (RFC 9745) and `Sunset` (RFC 8594) headers for
at least 90 days before removal.
