# Leasey API

> REST API (JSON over HTTPS) of Leasey.ai, the leasing platform for property managers: import and update rental units, syndicate them to 23 rental marketplaces with prices shown before publishing and billing per charge, find, book, reschedule, confirm and cancel property showings, pull leads, showings, portfolio and billing reports, run the leasing pipeline (create and send rental applications, change their stage and decision, order screening checks charged to the card on file, create leases and send them for e-signature, and read each application, check, lease and signature, never the screening report), and receive signed webhooks for leads and for application, screening, lease and e-signature changes. Organizations can manage many client companies with one key.

- Production base URL: `https://api.leasey.ai/v1` · Sandbox: `https://sandbox.api.leasey.ai/v1` (separate system, Stripe test mode).
- Authentication: a per-company API key in `Authorization: Bearer lsy_live_…` (sandbox `lsy_test_…`), created by company administrators in the Leasey dashboard (Profile → Developers); full-access or read-only, optionally limited to some resources; optional expiration. Organizations use `lsy_org_live_…` keys and the `/org` routes. Legacy token + company password still accepted.
- Errors are JSON with a stable `code`, a `message` and a `request_id` (also in the `X-Request-Id` header of every response). Writes accept an `Idempotency-Key` header. Reports paginate with `page`/`page_size` and support incremental sync with `updated_since`. Protective throttle: `429` with `Retry-After`.
- Versioning: `v1` is the major version in the URL; changes within it are additive and listed with dates in the changelog. Current docs release: 3.18.

## Docs

- [Leasey API Documentation](https://www.leasey.ai/leasey-api-documentation/): the documentation for people, with tutorials — General API (units, showings, reports, webhooks), Syndication API (marketplaces, pricing, billing, leads), Organizations, and the leasing pipeline (applications, screening, leases, e-signature).
- [Complete guide in Markdown](https://www.leasey.ai/api/leasey-api.md): the same content as plain Markdown, every endpoint with a real request and response.
- [OpenAPI 3.0 specification](https://www.leasey.ai/api/openapi.yaml): every public endpoint, parameter, schema and error, for Postman, code generators and AI tools.

## Optional

- [llms-full.txt](https://www.leasey.ai/llms-full.txt): the complete guide in a single plain-text file.