Skip to content

List leases for a unit

GET
/api/units/{id}/leases
curl --request GET \
--url https://api.getvespy.com/api/units/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/leases \
--header 'Authorization: Bearer <token>'
id
required
string format: uuid

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"
}
}
]
}

Default Response

Media typeapplication/json
object
code
string
errors
Array<object>
object
code
required
string
message
required
string
path
required
string
message
required
string
Examplegenerated
{
"code": "example",
"errors": [
{
"code": "example",
"message": "example",
"path": "example"
}
],
"message": "example"
}

Default Response

Media typeapplication/json
object
code
string
errors
Array<object>
object
code
required
string
message
required
string
path
required
string
message
required
string
Examplegenerated
{
"code": "example",
"errors": [
{
"code": "example",
"message": "example",
"path": "example"
}
],
"message": "example"
}

Default Response

Media typeapplication/json
object
code
string
errors
Array<object>
object
code
required
string
message
required
string
path
required
string
message
required
string
Examplegenerated
{
"code": "example",
"errors": [
{
"code": "example",
"message": "example",
"path": "example"
}
],
"message": "example"
}

Default Response

Media typeapplication/json
object
code
string
errors
Array<object>
object
code
required
string
message
required
string
path
required
string
message
required
string
Examplegenerated
{
"code": "example",
"errors": [
{
"code": "example",
"message": "example",
"path": "example"
}
],
"message": "example"
}