Changelog

2026-11-11 — API v1

• First public release. Base URL https://app.letfold.com/api/v1.
• Resources: agency, branches, properties (+ photos), landlords, tenants, leads, viewings, tenancies (+ rent schedule, arrears), payments, maintenance (+ notes), contractors, documents, certificates, tasks, webhook endpoints and deliveries.
• Writes: POST /leads (202), POST /viewings, PATCH /viewings/{id}, POST /maintenance, PATCH /maintenance/{id}, POST /maintenance/{id}/notes, POST /documents (multipart or url), POST /certificates, POST /tasks, webhook endpoint CRUD, test and redeliver.
• Conventions: Bearer keys with scopes, pii:read masking, cursor pagination, updated_since, RFC 9457 errors, Idempotency-Key, ETag / If-Match, 600 + 100 per-minute limits.
• Webhooks: 24 event types, Standard Webhooks signatures, retry ladder 5 s to 24 h, auto-disable after 7 days.
• Sandbox agency "Harbourside Lettings (sandbox)", reset nightly; partner access by request.
• OpenAPI 3.1 at /api/v1/openapi.json, rendered at /developers/reference.

Planned

• v2 (no date): partner apps installed by an agency with OAuth-style consent instead of a pasted key; api.letfold.com host.
• Read endpoints for inspections, offers and applicants; PATCH /leads/{id} status.