---
title: "Search the connected system's leases: by tenant name in Buildium, by lease name (which names its unit and tenants) in DoorLoop. At most 20 leases. A signed-in session in live mode only"
method: POST
path: "/v1/integrations/{system}/leases"
---

# Search the connected system's leases: by tenant name in Buildium, by lease name (which names its unit and tenants) in DoorLoop. At most 20 leases. A signed-in session in live mode only

`POST /v1/integrations/{system}/leases`

## Request

- Base URL: `https://api.evictionsapi.com`
- URL: `https://api.evictionsapi.com/v1/integrations/{system}/leases`
- Auth: HTTP bearer

## Path parameters

- `system` 'buildium' | 'doorloop', required

## Request body

- object
  - `search` string, required

## Response `200`

The leases found.

- object
  - `items` LeaseMatch[], required
    - `id` string, required: The system's lease id, for `pull`.
    - `name` string: The system's own name for the lease (DoorLoop).
    - `tenants` string[], required
    - `unit` string, required
    - `address` string, required
    - `start` string, date
    - `end` string, date
    - `balanceCents` integer: What the system says the tenant owes.

## Other responses

- `400`: The request is invalid.
- `401`: The credential is missing or invalid.
- `403`: `forbidden`: an API key (these routes take a signed-in session only), or, to connect or disconnect, a member who is not an owner.
- `404`: `not_connected`: the organization has not connected this system. `lease_not_found` (pull): the system has no such lease for the stored key.
- `409`: The request conflicts with the current state: for a case, it is not in a state that allows this, or its details were erased (`erased`); for an API key, a limit or the key in use.
- `422`: `live_only`: a session in test mode.
- `429`: `rate_limited`: at most 60 connects and searches an hour per organization, counted together. `Retry-After` gives the seconds to wait.
- `502`: `pms_refused`: the system refused the stored key (connect it again); `pms_unavailable`: the system did not answer as expected.
- `503`: `pms_busy`: the system asked us to wait.

---

[API](https://skmtc.dev/evictionsapi/apis/evictions-api.md) · [All operations](https://skmtc.dev/evictionsapi/apis/evictions-api/llms.txt) · [OpenAPI document](https://skmtc.dev/evictionsapi/apis/evictions-api/revisions/28459213a1a3?raw)