List leases

GET

/api/leases

curl --request GET \
  --url 'https://api.getvespy.com/api/leases?status=draft&sortBy=tenantName&sortDirection=asc' \
  --header 'Authorization: Bearer <token>'

• Production
• Development
• Local

Authorizations

• bearerAuth

Parameters

Query Parameters

search

string

>= 1 characters <= 100 characters

status

string

Allowed values: draft active ended terminated

propertyId

string format: uuid

tenantId

string format: uuid

unitId

string format: uuid

createdAfter

string format: date

createdBefore

string format: date

expiringAfterDays

integer

<= 364

expiringWithinDays

integer

>= 1 <= 365

minOverdueRentCents

integer

maxOverdueRentCents

integer

sortBy

string

Allowed values: tenantName propertyName unitNumber startDate endDate rentCents status createdAt overduePostedRentCents

sortDirection

string

Allowed values: asc desc

Responses

200

Default Response

Media typeapplication/json

object

leases

required

Array<object>

object

createdAt

required

string format: date-time

daysUntilExpiry

required

integer

nullable

deletedAt

required

string format: date-time

nullable

endDate

required

string format: date

nullable

id

required

string format: uuid

lateFeeAmountCents

required

integer

nullable >= 1

lateFeeGraceDays

required

integer

lateFeePercentBps

required

integer

nullable >= 1

lateFeeType

required

string

Allowed values: none flat percent

moveInDate

required

string format: date

occupants

required

Array<object>

object

isPrimary

required

boolean

moveInDate

required

string format: date

nullable

moveOutDate

required

string format: date

nullable

providerRole

required

string

nullable

tenantId

required

string format: uuid

tenantName

required

string

>= 1 characters <= 160 characters

organizationId

required

string format: uuid

overduePostedRentCents

integer

propertyId

required

string format: uuid

propertyName

required

string

renewedFromLeaseId

required

string format: uuid

nullable

rentCents

required

integer

>= 1

rentChargeDay

required

integer

>= 1 <= 31

signedAt

required

string format: date-time

nullable

startDate

required

string format: date

status

required

string

Allowed values: draft active ended terminated

tenantId

required

string format: uuid

tenantName

required

string

termType

required

string

Allowed values: fixed month_to_month

terminationDate

required

string format: date

nullable

unitId

required

string format: uuid

unitNumber

required

string

nullable

noteSummaries

required

Array<object>

object

entityId

required

string format: uuid

latestNote

required

object

body

required

string

>= 1 characters <= 4000 characters

createdAt

required

string format: date-time

visibility

required

string

Allowed values: organization_only tenant_shared vendor_shared tenant_vendor_shared

noteCount

required

integer

Example

{
  "leases": [
    {
      "lateFeeType": "none",
      "status": "draft",
      "termType": "fixed"
    }
  ],
  "noteSummaries": [
    {
      "latestNote": {
        "visibility": "organization_only"
      }
    }
  ]
}

400

Default Response

Media typeapplication/json

object

code

string

errors

Array<object>

object

code

required

string

message

required

string

path

required

string

message

required

string

Example^generated

{
  "code": "example",
  "errors": [
    {
      "code": "example",
      "message": "example",
      "path": "example"
    }
  ],
  "message": "example"
}

401

Default Response

Media typeapplication/json

object

code

string

errors

Array<object>

object

code

required

string

message

required

string

path

required

string

message

required

string

Example^generated

{
  "code": "example",
  "errors": [
    {
      "code": "example",
      "message": "example",
      "path": "example"
    }
  ],
  "message": "example"
}

403

Default Response

Media typeapplication/json

object

code

string

errors

Array<object>

object

code

required

string

message

required

string

path

required

string

message

required

string

Example^generated

{
  "code": "example",
  "errors": [
    {
      "code": "example",
      "message": "example",
      "path": "example"
    }
  ],
  "message": "example"
}