VTS Lease Terms API
The Lease Terms API from VTS — 2 operation(s) for lease terms.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/vts-lease-terms-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: VTS Lease Account Admin Lease Terms API
version: v1
description: VTS Lease REST API — the commercial real estate leasing, asset management, and portfolio data surface of the VTS platform. Resources include assets, spaces, leases, deals, deal terms, lease terms, financials, budgets, tenants, buildings, listings, and the Leasing Availability API. Harvested verbatim from the VTS developer portal (readme.vts.com) per-operation OpenAPI fragments.
contact:
name: VTS API Support
url: https://readme.vts.com/
termsOfService: https://www.vts.com/services-terms
servers:
- url: https://api.vts.com
- url: https://sandbox.vts.com
description: Sandbox
security:
- basic_auth: []
tags:
- name: Lease Terms
paths:
/api/v1/lease_terms:
get:
summary: Fetches lease terms
description: Contains attributes of a given lease term including possession date, lease type, and calculated rents
tags:
- Lease Terms
security:
- basic_auth: []
parameters:
- name: page[size]
in: query
required: false
schema:
type: integer
- name: page[before]
in: query
required: false
schema:
type: string
- name: page[after]
in: query
required: false
schema:
type: string
- name: filter[updated_since]
in: query
schema:
type: string
format: date-time
required: false
description: Only display records that have been modified after the given date/timestamp. Should be in `YYYY-MM-DD HH:MM:SS` (ISO8601) format. (Hours, minutes, and seconds are optional.)
example: '2021-03-15'
responses:
'200':
description: Returns list of LeaseTerms
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
type:
type: string
example: lease_terms
id:
type: string
example: '1'
attributes:
type: object
properties:
calculated_rents:
type: object
properties:
expiring_base_rent:
$ref: '#/components/schemas/measure_money_area_period'
expiring_gross_rent:
$ref: '#/components/schemas/measure_money_area_period'
in_place_base_rent:
$ref: '#/components/schemas/measure_money_area_period'
in_place_gross_rent:
$ref: '#/components/schemas/measure_money_area_period'
reimbursable_expenses:
type: array
items:
type: object
properties:
type:
type: string
example: OperationalExpense
enum:
- OperationalExpense
- RealEstateTax
- ReimbursableExpenseCleaning
- ReimbursableExpenseInsurance
- ReimbursableExpenseMarketing
- ReimbursableExpenseOm
- ReimbursableExpenseOther
- ReimbursableExpenseRepairsAndMaintenance
- ReimbursableExpenseSecurity
- ReimbursableExpenseUtility
- ReimbursableExpenseCam
- ReimbursableExpenseElectric
- ReimbursableExpenseLandscaping
- ReimbursableExpenseManagementFee
description: The type of the reimbursable expense
start_date:
type: string
example: '2022-03-02'
end_date:
type: string
example: '2023-03-02'
amount:
oneOf:
- $ref: '#/components/schemas/measure_money_area_period'
- $ref: '#/components/schemas/measure_money_period'
commencement_date:
type: string
format: date
created_at:
type: string
format: date-time
term_type:
type:
- string
- 'null'
example: Renewal
description: The purpose of the deal (new, renewal, expansion)
entered_date:
type: string
format: date
description: Date the Lease was added to VTS
execution_date:
type: string
format: date
description: The date the Lease is executed—usually the same as the commencement date.
structure:
type: string
enum:
- full service
- triple net
- modified gross
example: full service
description: Type of the lease the lease term belongs to
deal_type:
type: string
example: new
enum:
- new
- original
- renewal
- renewal_two
- renewal_three
- extension
- expansion
- termination
- modification
- sublease
- license_agreement
- storage
- specialty
- short_term_lease
- other
- relocation
- rent_review
- break
- fixed_option
description:
type:
- string
- 'null'
example: This is a lease term.
downtime:
allOf:
- $ref: '#/components/schemas/measure_period'
- type:
- object
- 'null'
properties:
magnitude:
example: 2
unit:
enum:
- mo
unit_components:
properties:
period:
enum:
- mo
iso8601:
example: P2M
description: Months from previous tenant move-out to commencement date of replacement tenant
expiration_date:
type: string
format: date
gaap_rent:
$ref: '#/components/schemas/measure_money'
is_month_to_month:
type: boolean
lease_type:
type: string
example: full service
move_out_date:
type:
- string
- 'null'
format: date
possession_date:
type:
- string
- 'null'
format: date
rent_commencement_date:
type:
- string
- 'null'
format: date
rentable_size:
$ref: '#/components/schemas/measure_size'
lock_in_end_date:
type:
- string
- 'null'
format: date
retail:
type: object
properties:
description:
type:
- string
- 'null'
growth_rate:
type: number
percent_rent:
type: number
estimated_sales:
$ref: '#/components/schemas/measure_money_period'
natural_breakpoint:
$ref: '#/components/schemas/measure_money_period'
unnatural_breakpoint:
$ref: '#/components/schemas/measure_money_period'
percentage_rents:
type: array
items:
type: object
properties:
start_date:
type: string
format: date
example: '2022-03-13'
description: The start date in which the percentage rent revenue applies
end_date:
type: string
format: date
example: '2022-04-13'
description: The end date in which the percentage rent revenue applies
amount:
oneOf:
- $ref: '#/components/schemas/measure_money_area_period'
- $ref: '#/components/schemas/measure_money_period'
description: The amount of the percentage rent revenue
description: Amount of the tenant's sales that must be paid as rent to the landlord
sourceid:
type:
- string
- 'null'
example: '000004353'
tenant_buildout_period:
$ref: '#/components/schemas/measure_period'
term_duration:
$ref: '#/components/schemas/measure_period'
updated_at:
type: string
format: date-time
lease_infos:
type: array
items:
type: object
properties:
type:
type: string
example: guarantor
enum:
- guarantor
- tenant notice info
- lease drafter
- certificate of insurance
- development impact
- other
description: The type of the lease info
description:
type:
- string
- 'null'
example: My description
description: Lease info description
other_incomes:
type: array
items:
type: object
properties:
type:
type: string
example: parking
enum:
- parking
- storage
- signage
- fitout
- promotional_charges
- interest
- other
description: The type of the other income
start_date:
type: string
example: '2022-03-02'
end_date:
type: string
example: '2023-03-02'
amount:
oneOf:
- $ref: '#/components/schemas/measure_money_area_period'
- $ref: '#/components/schemas/measure_money_period'
description: Value of other income that will be paid to landlord by the tenant
quantity:
type: number
example: '1'
description: The quantity of parking
description:
type:
- string
- 'null'
example: My description
description: Other income description
free_rents:
type: array
items:
type: object
properties:
start_date:
type: string
example: '2022-03-02'
end_date:
type: string
example: '2023-03-02'
amount:
oneOf:
- $ref: '#/components/schemas/measure_money_area_period'
- $ref: '#/components/schemas/measure_money_period'
description: This is the amount to be discounted from the base rent
base_rents:
type: array
items:
type: object
properties:
start_date:
type: string
format: date
example: '2022-03-02'
end_date:
type: string
format: date
example: '2023-03-02'
amount:
oneOf:
- $ref: '#/components/schemas/measure_money_area_period'
- $ref: '#/components/schemas/measure_money_period'
description: This is the per unit rent due over the select duration
commissions:
$ref: '#/components/schemas/commissions'
costs:
type: array
items:
type: object
properties:
type:
type: string
enum:
- tenant_improvement
- building_improvement
- other_fee
example: tenant_improvement
description: The type of the cost
occurrence_month:
type: number
example: 1
description: The occurrence month of the cost. Possible values are between 1 and the number of months in the term
amount:
oneOf:
- $ref: '#/components/schemas/measure_money'
- $ref: '#/components/schemas/measure_money_period'
description: The amount, with units, of the cost
description:
type: string
example: Description
description: The description of the cost
relationships:
type: object
properties:
lease:
type: object
properties:
data:
type:
- object
- 'null'
properties:
id:
type: string
example: '12345'
type:
type: string
enum:
- leases
example: leases
links:
type: object
properties:
related:
type: string
format: uri
spaces:
type: object
properties:
data:
type: array
items:
type:
- object
- 'null'
properties:
id:
type: string
example: '12345'
type:
type: string
enum:
- spaces_office
example: spaces_office
links:
type: object
properties:
self:
type: string
example: https://api.vts.com/api/v1/lease_terms
prev:
type: string
example: https://api.vts.com/api/v1/lease_terms?page%5Bbefore%5D=MzE2NTI%253D
next:
type: string
example: https://api.vts.com/api/v1/lease_terms?page%5Bafter%5D=MzE2NjQ%253D
required:
- self
'403':
description: API not authorized for use
content:
application/json:
schema:
$ref: '#/components/schemas/errors_object'
operationId: get_api-v1-lease-terms
/api/v1/lease_terms/{id}:
get:
summary: Retrieves specific lease term
description: Contains attributes of a given lease term including possession date, lease type, and calculated rents
tags:
- Lease Terms
security:
- basic_auth: []
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Returns requested lease_term if it exists
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
type:
type: string
example: lease_terms
id:
type: string
example: '1'
attributes:
type: object
properties:
calculated_rents:
type: object
properties:
expiring_base_rent:
$ref: '#/components/schemas/measure_money_area_period'
expiring_gross_rent:
$ref: '#/components/schemas/measure_money_area_period'
in_place_base_rent:
$ref: '#/components/schemas/measure_money_area_period'
in_place_gross_rent:
$ref: '#/components/schemas/measure_money_area_period'
reimbursable_expenses:
type: array
items:
type: object
properties:
type:
type: string
example: OperationalExpense
enum:
- OperationalExpense
- RealEstateTax
- ReimbursableExpenseCleaning
- ReimbursableExpenseInsurance
- ReimbursableExpenseMarketing
- ReimbursableExpenseOm
- ReimbursableExpenseOther
- ReimbursableExpenseRepairsAndMaintenance
- ReimbursableExpenseSecurity
- ReimbursableExpenseUtility
- ReimbursableExpenseCam
- ReimbursableExpenseElectric
- ReimbursableExpenseLandscaping
- ReimbursableExpenseManagementFee
description: The type of the reimbursable expense
start_date:
type: string
example: '2022-03-02'
end_date:
type: string
example: '2023-03-02'
amount:
oneOf:
- $ref: '#/components/schemas/measure_money_area_period'
- $ref: '#/components/schemas/measure_money_period'
commencement_date:
type: string
format: date
created_at:
type: string
format: date-time
term_type:
type:
- string
- 'null'
example: Renewal
description: The purpose of the deal (new, renewal, expansion)
entered_date:
type: string
format: date
description: Date the Lease was added to VTS
execution_date:
type: string
format: date
description: The date the Lease is executed—usually the same as the commencement date.
structure:
type: string
enum:
- full service
- triple net
- modified gross
example: full service
description: Type of the lease the lease term belongs to
deal_type:
type: string
example: new
enum:
- new
- original
- renewal
- renewal_two
- renewal_three
- extension
- expansion
- termination
- modification
- sublease
- license_agreement
- storage
- specialty
- short_term_lease
- other
- relocation
- rent_review
- break
- fixed_option
description:
type:
- string
- 'null'
example: This is a lease term.
downtime:
allOf:
- $ref: '#/components/schemas/measure_period'
- type:
- object
- 'null'
properties:
magnitude:
example: 2
unit:
enum:
- mo
unit_components:
properties:
period:
enum:
- mo
iso8601:
example: P2M
description: Months from previous tenant move-out to commencement date of replacement tenant
expiration_date:
type: string
format: date
gaap_rent:
$ref: '#/components/schemas/measure_money'
is_month_to_month:
type: boolean
lease_type:
type: string
example: full service
move_out_date:
type:
- string
- 'null'
format: date
possession_date:
type:
- string
- 'null'
format: date
rent_commencement_date:
type:
- string
- 'null'
format: date
rentable_size:
$ref: '#/components/schemas/measure_size'
lock_in_end_date:
type:
- string
- 'null'
format: date
retail:
type: object
properties:
description:
type:
- string
- 'null'
growth_rate:
type: number
percent_rent:
type: number
estimated_sales:
$ref: '#/components/schemas/measure_money_period'
natural_breakpoint:
$ref: '#/components/schemas/measure_money_period'
unnatural_breakpoint:
$ref: '#/components/schemas/measure_money_period'
percentage_rents:
type: array
items:
type: object
properties:
start_date:
type: string
format: date
example: '2022-03-13'
description: The start date in which the percentage rent revenue applies
end_date:
type: string
format: date
example: '2022-04-13'
description: The end date in which the percentage rent revenue applies
amount:
oneOf:
- $ref: '#/components/schemas/measure_money_area_period'
- $ref: '#/components/schemas/measure_money_period'
description: The amount of the percentage rent revenue
description: Amount of the tenant's sales that must be paid as rent to the landlord
sourceid:
type:
# --- truncated at 32 KB (48 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/vts/refs/heads/main/openapi/vts-lease-terms-api-openapi.yml