VTS Proposals API
The Proposals API from VTS — 3 operation(s) for proposals.
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-proposals-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 Proposals 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: Proposals
paths:
/api/v1/deals/{deal_id}/proposals:
get:
summary: Fetches proposals
description: Contains details of a given proposal, including discount rate, proposal type, and description
tags:
- Proposals
security:
- basic_auth: []
parameters:
- name: deal_id
in: path
required: true
schema:
type: string
- 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[latest]
in: query
required: false
description: Only show the latest Proposal
schema:
type: boolean
- 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 Proposals
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
type:
type: string
example: proposals
id:
type: string
example: '1'
attributes:
type: object
properties:
proposal_label:
type:
- string
- 'null'
example: Proposal Name
description: The name of the proposal
calculated_metrics:
type: object
properties:
net_effective_rent:
allOf:
- $ref: '#/components/schemas/measure_money_area_period'
- properties:
magnitude:
example: 35
unit:
example: USD/sf/mo
unit_components:
properties:
period:
enum:
- mo
description: 'Possible values: ''mo'''
description: "The normalized value a tenant will pay per period to the landlord over the length of a\n lease considering Net Present Value. Returned in money/area/month units"
ner_to_termination:
allOf:
- $ref: '#/components/schemas/measure_money_area_period'
- properties:
magnitude:
example: 35
unit:
example: USD/sf/mo
unit_components:
properties:
period:
enum:
- mo
description: 'Possible values: ''mo'''
description: The NER in light of a termination right added to the proposal. Returned in money/area/month units
ner_with_downtime:
allOf:
- $ref: '#/components/schemas/measure_money_area_period'
- properties:
magnitude:
example: 35
unit:
example: USD/sf/mo
unit_components:
properties:
period:
enum:
- mo
description: 'Possible values: ''mo'''
description: The NER in light of a downtime included in the proposal. Returned in money/area/month units
ner_vs_budget:
type:
- number
- 'null'
example: 1
description: Net Effective Rent as a percent of NER of budget
ner_to_termination_vs_budget:
type:
- number
- 'null'
example: 1
description: '"NER to termination" as a percent of NER of the budget'
net_present_value:
allOf:
- $ref: '#/components/schemas/measure_money'
- description: The present value of the net cash flow given the time value of money
net_rent:
allOf:
- $ref: '#/components/schemas/measure_money_area_period'
- properties:
magnitude:
example: 35
unit:
example: USD/sf/yr
unit_components:
properties:
period:
enum:
- yr
description: 'Possible values: ''yr'''
description: Total cash received from base rent + escalation - free rent. Returned in money/area/year units
total_capital:
allOf:
- $ref: '#/components/schemas/measure_money'
- description: Total cash being paid out as part of costs associated with TI + BI + Other Fees + Commissions
total_net_cash_flow:
allOf:
- $ref: '#/components/schemas/measure_money'
- description: Total cash inflows minus outflows per the terms over the lifetime of the lease
total_base_rent:
allOf:
- $ref: '#/components/schemas/measure_money'
- description: Total base rent over the lifetime of the lease
deprecated: true
total_escalated_rent_before_abatement:
allOf:
- $ref: '#/components/schemas/measure_money'
- description: Total base rent before abatement over the lifetime of the lease which includes the sum of base_rent + rent_escalation
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
entered_date:
type: string
format: date
latest:
type: boolean
discount_rate:
type:
- number
- 'null'
example: 0.08
description:
type:
- string
- 'null'
example: This is a proposal.
proposal_date:
type: string
format: date
proposal_type:
type: string
example: final
relationships:
type: object
properties:
deal:
type: object
properties:
data:
type:
- object
- 'null'
properties:
id:
type: string
example: '12345'
type:
type: string
enum:
- deals
example: deals
links:
type: object
properties:
related:
type: string
format: uri
deal_terms:
type: object
properties:
data:
type: array
items:
type:
- object
- 'null'
properties:
id:
type: string
example: '12345'
type:
type: string
enum:
- deal_terms
example: deal_terms
options:
type: object
properties:
data:
type: array
items:
type:
- object
- 'null'
properties:
id:
type: string
example: '12345'
type:
type: string
enum:
- options_miscellaneous
- options_co_tenancy
- options_contraction
- options_encumberance
- options_exclusive_use
- options_purchase
- options_rent_review
- options_renewal
- options_expansion
- options_termination
example: options_miscellaneous
links:
type: object
properties:
self:
type: string
example: https://api.vts.com/api/v1/deals/1/proposals
prev:
type: string
example: https://api.vts.com/api/v1/deals/12345/proposals?page%5Bbefore%5D=MzE2NTI%253D
next:
type: string
example: https://api.vts.com/api/v1/deals/12345/proposals?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-deals-deal-id-proposals
/api/v1/proposals:
get:
summary: Fetches proposals
description: Contains details of a given proposal, including discount rate, proposal type, and description
tags:
- Proposals
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
responses:
'200':
description: Returns list of Proposals
content:
application/json:
schema:
type: object
properties:
data:
type: array
items:
type: object
properties:
type:
type: string
example: proposals
id:
type: string
example: '1'
attributes:
type: object
properties:
proposal_label:
type:
- string
- 'null'
example: Proposal Name
description: The name of the proposal
calculated_metrics:
type: object
properties:
net_effective_rent:
allOf:
- $ref: '#/components/schemas/measure_money_area_period'
- properties:
magnitude:
example: 35
unit:
example: USD/sf/mo
unit_components:
properties:
period:
enum:
- mo
description: 'Possible values: ''mo'''
description: "The normalized value a tenant will pay per period to the landlord over the length of a\n lease considering Net Present Value. Returned in money/area/month units"
ner_to_termination:
allOf:
- $ref: '#/components/schemas/measure_money_area_period'
- properties:
magnitude:
example: 35
unit:
example: USD/sf/mo
unit_components:
properties:
period:
enum:
- mo
description: 'Possible values: ''mo'''
description: The NER in light of a termination right added to the proposal. Returned in money/area/month units
ner_with_downtime:
allOf:
- $ref: '#/components/schemas/measure_money_area_period'
- properties:
magnitude:
example: 35
unit:
example: USD/sf/mo
unit_components:
properties:
period:
enum:
- mo
description: 'Possible values: ''mo'''
description: The NER in light of a downtime included in the proposal. Returned in money/area/month units
ner_vs_budget:
type:
- number
- 'null'
example: 1
description: Net Effective Rent as a percent of NER of budget
ner_to_termination_vs_budget:
type:
- number
- 'null'
example: 1
description: '"NER to termination" as a percent of NER of the budget'
net_present_value:
allOf:
- $ref: '#/components/schemas/measure_money'
- description: The present value of the net cash flow given the time value of money
net_rent:
allOf:
- $ref: '#/components/schemas/measure_money_area_period'
- properties:
magnitude:
example: 35
unit:
example: USD/sf/yr
unit_components:
properties:
period:
enum:
- yr
description: 'Possible values: ''yr'''
description: Total cash received from base rent + escalation - free rent. Returned in money/area/year units
total_capital:
allOf:
- $ref: '#/components/schemas/measure_money'
- description: Total cash being paid out as part of costs associated with TI + BI + Other Fees + Commissions
total_net_cash_flow:
allOf:
- $ref: '#/components/schemas/measure_money'
- description: Total cash inflows minus outflows per the terms over the lifetime of the lease
total_base_rent:
allOf:
- $ref: '#/components/schemas/measure_money'
- description: Total base rent over the lifetime of the lease
deprecated: true
total_escalated_rent_before_abatement:
allOf:
- $ref: '#/components/schemas/measure_money'
- description: Total base rent before abatement over the lifetime of the lease which includes the sum of base_rent + rent_escalation
created_at:
type: string
format: date-time
updated_at:
type: string
format: date-time
entered_date:
type: string
format: date
latest:
type: boolean
discount_rate:
type:
- number
- 'null'
example: 0.08
description:
type:
- string
- 'null'
example: This is a proposal.
proposal_date:
type: string
format: date
proposal_type:
type: string
example: final
relationships:
type: object
properties:
deal:
type: object
properties:
data:
type:
- object
- 'null'
properties:
id:
type: string
example: '12345'
type:
type: string
enum:
- deals
example: deals
links:
type: object
properties:
related:
type: string
format: uri
deal_terms:
type: object
properties:
data:
type: array
items:
type:
- object
- 'null'
properties:
id:
type: string
example: '12345'
type:
type: string
enum:
- deal_terms
example: deal_terms
links:
type: object
properties:
related:
type: string
format: uri
options:
type: object
properties:
data:
type: array
items:
type:
- object
- 'null'
properties:
id:
type: string
example: '12345'
type:
type: string
enum:
- options_miscellaneous
- options_co_tenancy
- options_contraction
- options_encumberance
- options_exclusive_use
- options_purchase
- options_rent_review
- options_renewal
- options_expansion
- options_termination
example: options_miscellaneous
'403':
description: API not authorized for use
content:
application/json:
schema:
$ref: '#/components/schemas/errors_object'
operationId: get_api-v1-proposals
/api/v1/proposals/{id}:
get:
summary: Retrieves specific proposal
description: Contains details of a given proposal, including discount rate, proposal type, and description
tags:
- Proposals
security:
- basic_auth: []
parameters:
- name: id
in: path
required: true
schema:
type: string
responses:
'200':
description: Returns requested proposal if it exists
content:
application/json:
schema:
type: object
properties:
data:
type: object
properties:
type:
type: string
example: proposals
id:
type: string
example: '1'
attributes:
type: object
properties:
proposal_label:
type:
- string
- 'null'
example: Proposal Name
description: The name of the proposal
calculated_metrics:
type: object
properties:
net_effective_rent:
allOf:
- $ref: '#/components/schemas/measure_money_area_period'
- properties:
magnitude:
example: 35
unit:
example: USD/sf/mo
unit_components:
properties:
period:
enum:
- mo
description: 'Possible values: ''mo'''
description: "The normalized value a tenant will pay per period to the landlord over the length of a\n lease considering Net Present Value. Returned in money/area/month units"
ner_to_termination:
allOf:
- $ref: '#/components/schemas/measure_money_area_period'
- properties:
magnitude:
example: 35
unit:
example: USD/sf/mo
unit_components:
properties:
period:
enum:
- mo
description: 'Possible values: ''mo'''
description: The NER in light of a termination right added to the proposal. Returned in money/area/month units
ner_with_downtime:
allOf:
- $ref: '#/components/schemas/measure_money_area_period'
- properties:
magnitude:
example: 35
unit:
example: USD/sf/mo
unit_components:
properties:
period:
enum:
- mo
description: 'Possible values: ''mo'''
description: The NER in light of a downtime included in the proposal. Returned in money/area/month units
ner_vs_budget:
type:
- number
- 'null'
example: 1
description: Net Effective Rent as a percent of NER of budget
ner_to_termination_vs_budget:
type:
- number
- 'null'
example: 1
description: '"NER to termination" as a percent of NER of the budget'
net_present_value:
allOf:
- $ref: '#/components/schemas/measure_money'
- description: The present value of the net cash flow given the time value of money
net_rent:
allOf:
- $ref: '#/components/schemas/measure_money_area_period'
- properties:
magnitude:
example: 35
unit:
example: USD/sf/yr
unit_components:
properties:
# --- truncated at 32 KB (40 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/vts/refs/heads/main/openapi/vts-proposals-api-openapi.yml