> ## Documentation Index > Fetch the complete documentation index at: https://docs.prophia.com/llms.txt > Use this file to discover all available pages before exploring further. # CREATE Lease > Creates a Lease in the given Building. A Lease is required in order to create a Document **Required capabilities:** `WRITE:LEASE` ## OpenAPI ````yaml /api-reference/openapi.json post /rest/v2/accounts/{accountId}/leases openapi: 3.1.0 info: title: Prophia API Documentation license: name: Apache 2.0 url: http://springdoc.org version: v2.495.0 servers: - url: https://api.prophia.com description: Prophia API security: - apiKey: [] tags: - name: Accounts description: >- Accounts are the top-level scope for everything in the API. Start here: list your accounts to find the `accountId` every other path requires. - name: Properties description: >- Properties group one or more buildings under a single asset within an account. - name: Buildings description: Buildings are the physical structures where leases and spaces live. - name: Building Spaces description: >- Building spaces are the units inside a building — suites, floors, storage. A space's `suiteNumber` is the canonical name that tag `applicableSpaces` entries reference by string match. - name: Leases description: >- Leases are the agreements occupying building spaces. Each lease carries its source documents and the tags (structured terms) extracted from them. - name: Documents description: >- Documents are the source files attached to leases — original leases, amendments, memorandums, etc. - name: Tags description: >- Tags are the structured lease terms Prophia extracts from documents — a rent amount, a renewal option, a key date — each cited to its location in the source document. STANDARD tags carry a typed `value`; COMPLEX tags carry option details in `tagComponents`. - name: Custom Terms description: >- Custom terms are account-level definitions of extra lease terms your team tracks beyond Prophia's standard set. Tags created from them are ordinary tags with `isCustomTag: true` — the definition and its tag instances are separate resources. - name: Custom Fields description: >- Custom Fields are Account-level fields your team tracks on Buildings beyond Prophia's standard set. A `SINGLE` field holds free text per Building; a `MULTI` field holds one of a fixed list of options. Assignments set a field's value on a Building. - name: Loans description: >- Loans are the financing agreements secured by an account's buildings. Each loan carries its source documents and the terms read from them: summary terms, covenants and reporting deliverables. Loans is a Labs feature in beta, and its endpoints may change. x-beta: true paths: /rest/v2/accounts/{accountId}/leases: post: tags: - Leases summary: CREATE Lease description: >- Creates a Lease in the given Building. A Lease is required in order to create a Document **Required capabilities:** `WRITE:LEASE` operationId: createLease parameters: - name: accountId in: path required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/V2CreateLeaseRequest' required: true responses: '200': description: OK content: '*/*': schema: $ref: '#/components/schemas/V2LeaseModel' '400': description: Invalid input — request body failed validation or business rules content: application/json: schema: $ref: '#/components/schemas/V2ErrorResponse' example: error: Invalid Input errorCode: InvalidInput message: dba cannot be blank status: 400 BAD_REQUEST timestamp: '2026-09-02T20:41:03.118Z' localizedMessage: dba cannot be blank '401': description: >- The credential was rejected before the request reached the endpoint — for example a JWT was presented where an API key is required. Only `error` is populated on this path content: application/json: schema: $ref: '#/components/schemas/V2ErrorResponse' example: error: JWT authentication is not supported. Use an API key. '403': description: >- The API key is valid but lacks a required capability or role, the account does not have the REST write module enabled, or the key's building permissions do not cover the requested resource. The message names the missing capabilities only in the first case content: application/json: schema: $ref: '#/components/schemas/V2ErrorResponse' example: error: Access Denied errorCode: AccessDenied message: 'Not authorized. Missing capabilities: WRITE:DOCUMENT' status: 403 FORBIDDEN timestamp: '2026-09-02T20:41:03.118Z' localizedMessage: 'Not authorized. Missing capabilities: WRITE:DOCUMENT' '404': description: No such resource is visible to the account named in the path content: application/json: schema: $ref: '#/components/schemas/V2ErrorResponse' example: error: Entity Not Found errorCode: EntityNotFound message: This entity is not found in the system. status: 404 NOT_FOUND timestamp: '2026-09-02T20:41:03.118Z' localizedMessage: This entity is not found in the system. components: schemas: V2CreateLeaseRequest: type: object description: >- Fields for creating a Lease in a Building. Prophia extracts the lease's terms from Documents attached afterwards; the fields here are the Lease record's own identity. properties: dba: type: string description: Tenant DBA — the display name for the lease. minLength: 1 buildingId: type: string description: >- Building the lease occupies. Must belong to the account in the path. Note: Does not accept `Building.customId`. minLength: 1 customId: type: string description: >- Your custom external identifier for the lease, for cross-referencing with your own systems. This value is purely for external reference and is unused in Prophia's system. parentLeaseId: type: string description: >- Set to create this lease as a sublease of the given lease. Must name a primary lease in the same `buildingId` as this one: an id that does not exist, sits in a different Building or Account, or names a Building, Property or Tenant folder is rejected as not found, and a lease that is itself a sublease is rejected — subleases are one level deep. Leave it out, or send it blank, to create an ordinary primary lease. leaseType: type: string description: >- Classification of the agreement. Defaults to `OFFICE` when omitted. Some lease types have specialized Tag sets available to them: GSA_OFFICE and RETAIL leases each have unique Tags available for capture that other lease types do not. Changing a lease's type removes those specialized Tags from the UI, APIs, and Reports, but does not delete them — reverting to the matching type brings them back. enum: - OFFICE - GSA_OFFICE - RETAIL - INDUSTRIAL - STORAGE - LICENSE_AGREEMENT - TELECOM_ANTENNA - PARKING_AGREEMENT - ROOFTOP_SOLAR required: - buildingId - dba V2LeaseModel: type: object description: >- Representation of a single Lease. A Lease is directly associated with one Building, denoted by its `buildingId` reference. A Lease's current active residence can be in one or more Buildings, which may or may not be its original Building reference - inspect the `suiteNumber` field to understand which BuildingSpaces in which Buildings the Lease is currently active in. properties: id: type: string description: Prophia internal Lease ID (UUID). readOnly: true accountId: type: string description: The Account the Lease is associated with. readOnly: true propertyId: type: string description: >- The propertyId (UUID) of Property the Lease was uploaded to; usually the property the Lease was initially occupying suites inside of. readOnly: true propertyCustomId: type: string description: >- The property's custom external identifier, for cross-referencing with your own systems. This value is purely for external reference and is unused in Prophia's system. readOnly: true propertyName: type: string description: The name of the Property the Lease was uploaded to. readOnly: true buildingId: type: string description: The buildingId (UUID) of the Building the Lease was uploaded to. readOnly: true buildingCustomId: type: string description: >- The building's custom external identifier, for cross-referencing with your own systems. This value is purely for external reference only and it unused in Prophia's system. readOnly: true buildingName: type: string description: The name of the Building the Lease was uploaded to. readOnly: true buildingType: type: string description: Asset type of the lease's building. enum: - OFFICE - INDUSTRIAL - RETAIL - MIXED_USE - OTHER - LIFE_SCIENCES - MEDICAL_OFFICE - FLEX readOnly: true address: $ref: '#/components/schemas/Address' description: Address of the Building the Lease was uploaded to. readOnly: true tenantLegalName: type: string description: >- Tenant's legal entity name sourced from the Lease data. Use `dba` for the display name. readOnly: true dba: type: string description: >- Tenant's doing-business-as name — the display name used throughout the app. customId: type: string description: >- Your custom external identifier for the lease, for cross-referencing with your own systems. This value is purely for external reference and is unused in Prophia's system. url: type: string description: Deep link to this Lease in the Prophia web app. readOnly: true leaseStatus: type: string description: >- Headline lease state as shown in the app. On this endpoint it is one of `Active`, `Expired`, or `Not Started` — note the spacing and casing — but it is typed as a free-form string rather than an enum, because the same field name carries a wider set on the v0 API, so do not switch on it exhaustively. It is derived, not stored: Prophia recomputes it from the lease's commence and expiration dates against today, so it changes on its own as those dates pass. Pair with `leaseSubStatus` to tell an expired lease from one running month-to-month or one that has been vacated post-expiration. readOnly: true leaseType: type: string description: >- Classification of the agreement. Some lease types have specialized Tag sets available to them: GSA_OFFICE and RETAIL leases each have unique Tags available for capture that other lease types do not. Changing a lease's type removes those specialized Tags from the UI, APIs, and Reports, but does not delete them — reverting to the matching type brings them back. enum: - OFFICE - GSA_OFFICE - RETAIL - INDUSTRIAL - STORAGE - LICENSE_AGREEMENT - TELECOM_ANTENNA - PARKING_AGREEMENT - ROOFTOP_SOLAR leasedFloors: type: string description: >- Floors the lease occupies, as a comma-separated string. Derived rather than captured: each suite in `suiteNumber` is matched to a building space and contributes that space's `floor`, plus any floor named directly on a floor-scoped space. A suite that matches no building space contributes nothing, and a floor in another building is suffixed with `@buildingId` the way cross-building suites are. The order is not stable, and the value is rebuilt when Prophia consolidates the lease's tags — editing a space's `floor` afterwards leaves this stale until the next consolidation. readOnly: true suiteNumber: type: array description: >- Suites this lease occupies. May include references to Buildings that are not the Lease's direct ancestor when the Lease spans multiple Buildings or has relocated into a new Building in its lifetime. items: $ref: '#/components/schemas/V2SpaceModel' readOnly: true squareFootage: type: integer format: int32 description: Leased square footage. readOnly: true commenceDate: type: string format: date-time description: >- Lease commencement, as a calendar date (yyyy-MM-dd) with no time zone. See `floatingCommencement` when the date is not yet anchored. readOnly: true expirationDate: type: string format: date-time description: Lease expiration, as a calendar date (yyyy-MM-dd) with no time zone. readOnly: true tags: type: array description: >- The lease's extracted terms; only populated when `include=tags` is present in the request parameters. Filtered based the lease's current `leaseType`. Each tag appears once. A tag's `applicableSpaces` lists the suites it applies to in the lease's consolidated per-space view (a space-dependent term captured without suites applies to every space) and is omitted for space-independent terms. Lease-level values (commencement, expiration, square footage, suites) are on the lease's top-level fields. items: $ref: '#/components/schemas/V2DocTagModelEmbedded' documents: type: object additionalProperties: $ref: '#/components/schemas/V2DocumentPageModel' description: >- Per-document page geometry keyed by leaseDocId, for resolving tag citations; only populated when `include=documents` is present in the request parameters. readOnly: true leaseScore: $ref: '#/components/schemas/V2LeaseScoreModel' description: >- Prophia's computed Lease complexity score. Takes into account number and type of documents, tag data changes over time, and more. readOnly: true parent: $ref: '#/components/schemas/V2LeaseRef' description: Parent Lease, present only if this Lease is a sublease. readOnly: true leaseSubStatus: $ref: '#/components/schemas/V2LeaseSubStatusModel' description: >- Refines leaseStatus with the lease's current ongoing state (month-to-month, year-to-year, holdover) or post-expiration transition (vacated, extended). Omitted when none applies. readOnly: true docCompletionStatus: type: string description: >- Doc-completion rollup for the lease summary; `complete` when all Documents in the Lease have `documentStatus=complete`, otherwise `incomplete`. readOnly: true rentType: type: string description: >- Top-level rent classification for the lease (e.g. NNN, Gross). See `opexTaxTypes` for per-space classifications, which fall back to this value. enum: - Gross - Modified Gross - Single Net - NNN - Net of E - NN - Net - Unknown readOnly: true opexTaxTypes: type: array description: >- Per-occupied-space operating-expense / tax type, falling back to rentType when no per-space mapping exists. items: $ref: '#/components/schemas/V2OpexTaxTypeModel' readOnly: true floatingCommencement: type: boolean description: >- True when the lease's commencement date is floating (not anchored to a fixed calendar date). readOnly: true autoRenewalExpirationDates: type: array description: >- Per-space future expiration dates from auto-renewal options; excludes each space's pre-auto-renewal (original) expiration. items: $ref: '#/components/schemas/V2AutoRenewalExpirationDateModel' readOnly: true subleases: type: array description: >- Subleases under this Lease, only populated when the `include=subleases` is present in the request parameters. items: $ref: '#/components/schemas/V2LeaseRef' readOnly: true V2ErrorResponse: type: object properties: error: type: string description: Stable error category example: Invalid Input errorCode: type: string description: Stable error code suitable for programmatic handling example: InvalidInput message: type: string description: Human-readable detail; may aggregate multiple field errors status: type: string description: >- HTTP status of the response as code and reason phrase, matching the response's own status line example: 404 NOT_FOUND timestamp: type: string format: date-time description: When the error was produced, as an ISO-8601 UTC instant example: '2026-09-02T20:41:03.118Z' localizedMessage: type: string description: >- Same text as `message`; present because the body is a serialized exception. Prefer `message` Address: type: object properties: address1: type: string address2: type: string city: type: string state: type: string country: type: string zipcode: type: string V2SpaceModel: type: object description: >- Reference to space in a Building: one Building Space suiteNumber, an entire floor, the entire Building, or all spaces. `scope` says which of those it is, and `name` carries the label — for `BUILDING` and `ALL` that label is the sentinel `Entire building` or `All spaces` rather than the name of a real Building Space. The `ALL` scope means all suites in the relevant context are referenced: a Tag with `scope: ALL` refers to every suite defined in the suiteNumber tag belonging to that Document or Lease. properties: name: type: string description: >- The space's display name: a suite name that matches `BuildingSpace.suiteNumber` by string (scope SUITE), a floor designation (scope FLOOR), or the sentinels `Entire building` / `All spaces`. buildingId: type: string description: >- Building this entry refers to. Can differ from the parent lease's own Building when a lease spans multiple buildings or has relocated. scope: type: string description: >- Granularity of the reference: SUITE (one suite), FLOOR (a whole floor), BUILDING (the entire building), or ALL (all spaces). enum: - BUILDING - FLOOR - SUITE - ALL V2DocTagModelEmbedded: type: object description: >- V2DocTagModel as embedded in a parent response. This position omits tagSelections, pages, applicableSpaces. The `include` parameter is one level deep, so they are never populated in this position — fetch the resource directly to request them. properties: id: type: string description: Prophia internal Tag ID (UUID). readOnly: true tagName: type: string description: >- Machine name of the term (e.g. `rentSchedule`, `securityDeposit`). Tag names may occasionally appear in the format `optionName.componentTagName` denoting that the component tag belongs to a family of tags associated with that option name (e.g. autoRenewal.autoRenewalRate). displayName: type: string description: Human-readable term name as shown in the Prophia app. isCustomTag: type: boolean description: >- True when this tag instantiates one of the account's custom term definitions. category: type: string description: >- STANDARD: a single captured value — the `value` and `schedule` fields are the most common places to find relevant data for standard type Tags. COMPLEX: an option or right — the `tagComponents` field will contain data related to the component family related to the parent option Tag. EXHIBIT: captured exhibit data. enum: - STANDARD - COMPLEX - EXHIBIT value: description: >- The basic captured data for this Tag. Some tags may have additional customValues, tagComponents, or schedules that supplement this. Branch on `value.kind` for its shape: `date`, `number`, `money`, `percent`, and `text` carry a single `value`, while `dateRange` and `numberRange` carry `start` and `end` instead. Every kind also carries `unit`, `capturedData`, and `ocrText`, and the typed fields are omitted when `capturedData` could not be parsed into the kind's type — `capturedData` always holds the raw text. A numeric value captured with a percent unit arrives as `percent` — a pro-rata share (`prs`, `opexPrs`, `taxPrs`), a gross up, or a rent bump, for instance — carrying the percentage itself, so `3.5` means three and a half percent. Tags that accept both percent and dollar units, such as `rentBump` and `opexCap`, return `percent` or `money` according to the unit the value was captured with. A tag declared as a string type returns `text` even when a percent unit is present. oneOf: - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2DateRangeModel' - $ref: '#/components/schemas/V2MoneyModel' - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2NumberRangeModel' - $ref: '#/components/schemas/V2PercentModel' - $ref: '#/components/schemas/V2TextModel' customValue1: type: string description: Tag-specific extra field; meaning depends on the tag. customValue2: type: string description: Tag-specific extra field; meaning depends on the tag. customValue3: type: string description: Tag-specific extra field; meaning depends on the tag. customValue4: type: string description: Tag-specific extra field; meaning depends on the tag. customValue5: type: string description: Tag-specific extra field; meaning depends on the tag. customValue6: type: string description: Tag-specific extra field; meaning depends on the tag. schedule: $ref: '#/components/schemas/V2ScheduleModel' description: >- Series data for terms that carry one — rent steps, abatement periods, deposit burn-downs. Branch on `schedule.kind`. tagComponents: description: >- Structured detail for COMPLEX tags (options and rights). Branch on its `kind`. Null for STANDARD tags. oneOf: - $ref: '#/components/schemas/V2AutoRenewalComponent' - $ref: '#/components/schemas/V2ContractionComponent' - $ref: '#/components/schemas/V2EarlyTerminationComponent' - $ref: '#/components/schemas/V2ExpansionComponent' - $ref: '#/components/schemas/V2FeeComponent' - $ref: '#/components/schemas/V2GenericComponent' - $ref: '#/components/schemas/V2PurchaseComponent' - $ref: '#/components/schemas/V2RenewalComponent' - $ref: '#/components/schemas/V2RightOfFirstOfferComponent' - $ref: '#/components/schemas/V2RightOfFirstRefusalComponent' - $ref: '#/components/schemas/V2TenantImprovementComponent' amendingTag: $ref: '#/components/schemas/V2AmendingTag' description: >- Present when this tag amends/supersedes an earlier tag (its DB reference_id / OPTION option-group anchor). `amendedTagId` is the earlier (amended) tag's id; this is populated for any tag carrying a reference, not just OPTION/complex tags. For OPTION tags the same pointer is also mirrored inside tagComponents.amendingTag. lifecycleStatus: type: string description: >- State of this tag record across the lease's document history. Distinct from a component's `rightStatus` — the two are resolved independently and can disagree. Typically this lifecycle status refers to individual STANDARD tags or tagComponents. enum: - ACTIVE - VOID - STRICKEN - EXERCISED leaseId: type: string description: Lease this tag belongs to. leaseDocId: type: string description: Document this tag was extracted from. createdAt: type: string format: date-time description: When the tag was created. updatedAt: type: string format: date-time description: When the tag was last modified. url: type: string description: Deep link to this tag in the Prophia web app. V2DocumentPageModel: type: object description: >- The pages of a single document. Appears as the values of a lease's or loan's `documents` map, which is keyed by document id, so `documents[documentId].pages[docPageId]` resolves a tag citation to the page it sits on and the dimensions its bounding boxes scale against. properties: pages: type: object additionalProperties: $ref: '#/components/schemas/V2PageModel' description: >- Page geometry keyed by document page id — the value a tag citation carries in `tagSelections[].docPageId`. The page's own `id` field is omitted here because the id is the key; under a tag's `pages` include the same model carries `id` instead. V2LeaseScoreModel: type: object properties: score: type: integer format: int32 description: Prophia's complexity score for the lease's extracted record. missingMLA: type: boolean description: >- True when no primary Agreement (usually a Main Lease Agreement) document has been identified for the lease. V2LeaseRef: type: object description: >- Lightweight reference to another lease (e.g. the parent lease of a sublease, or a sublease of a primary lease). When the referenced lease's consolidated summary is available, leaseStatus and leaseSubStatus reflect its current derived state. properties: id: type: string description: The Lease id (UUID) of the referenced Lease. url: type: string description: Deep link to this Lease in the Prophia web app. leaseStatus: type: string description: >- Current [`leaseStatus`](/api-reference/v2/leases/get-lease#response-lease-status) of the referenced lease, when available. leaseSubStatus: $ref: '#/components/schemas/V2LeaseSubStatusModel' description: >- Current [`leaseSubStatus`](/api-reference/v2/leases/get-lease#response-lease-sub-status) of the referenced lease, when one applies. V2LeaseSubStatusModel: type: object description: >- Refinement of leaseStatus. Captures the lease's current ongoing state — month-to-month, year-to-year, or holdover — or whether it has transitioned post-expiration to vacated or extended. Omitted when none of those applies. properties: status: type: string description: The sub-status that currently applies to the lease. enum: - MONTH_TO_MONTH - YEAR_TO_YEAR - HOLDOVER - VACATED - EXTENDED startDate: type: string format: date-time description: Date the lease entered this sub-status, when known. V2OpexTaxTypeModel: type: object description: >- Operating-expense / tax recovery classification for a single occupied Building Space. Falls back to the lease-level rentType when no explicit per-space mapping exists. properties: space: $ref: '#/components/schemas/V2SpaceModel' description: Space (suite/floor) this classification applies to. opexTaxType: type: string description: >- Opex / tax type label (e.g. NNN, Gross). Resolved from the lease's per-space mapping; rentType is used as a fallback. enum: - Gross - Modified Gross - Single Net - NNN - Net of E - NN - Net - Unknown V2AutoRenewalExpirationDateModel: type: object description: >- Future expiration dates that arise from auto-renewal options on a single space. Excludes the lease's own current expiration date. properties: space: $ref: '#/components/schemas/V2SpaceModel' description: >- Space the auto-renewal expirations apply to. The data in this model can be referenced to Building Spaces. dates: type: array description: >- Ordered list of future expiration dates for the space built from applying captured auto-renewal periods to the Lease's original expiration date. items: type: string format: date-time V2DateModel: allOf: - $ref: '#/components/schemas/V2TagValue' - type: object properties: kind: type: string description: Discriminator for this shape — always `date` here. enum: - date value: type: string description: >- Present when `kind` is `date`. The captured date, `yyyy-MM-dd`. Omitted when the captured text was not parseable as a date; `capturedData` still holds what was captured. required: - kind description: >- `kind: date` — a single calendar date, serialized `yyyy-MM-dd`. `value` is omitted when the captured text was not parseable as a date, which is common for dates a lease states in relative terms; `capturedData` still holds what was captured. title: date V2DateRangeModel: allOf: - $ref: '#/components/schemas/V2TagValue' - type: object properties: kind: type: string description: Discriminator for this shape — always `dateRange` here. enum: - dateRange start: type: string description: >- Present when `kind` is `dateRange`. Inclusive start of the range, `yyyy-MM-dd`. Omitted together with `end` when `capturedData` could not be split into a parseable pair. end: type: string description: >- Present when `kind` is `dateRange`. Inclusive end of the range, `yyyy-MM-dd`. Omitted together with `start` when `capturedData` could not be split into a parseable pair. required: - kind description: >- `kind: dateRange` — a period bounded by two calendar dates, each serialized `yyyy-MM-dd`. Both bounds come from splitting one captured string, so both are omitted together when it could not be split into a parseable pair. title: dateRange V2MoneyModel: allOf: - $ref: '#/components/schemas/V2TagValue' - type: object properties: kind: type: string description: Discriminator for this shape — always `money` here. enum: - money value: type: string description: >- Present when `kind` is `money`. Decimal string (not a JSON number) holding a BigDecimal rounded to 2 decimals — preserves cent precision through JSON, e.g. "120000.00". currency: type: string description: Currency code for the value (e.g. USD). required: - kind description: >- `kind: money` — a currency amount. Produced when the term was captured with a currency unit; `currency` is the containing lease's currency, not a per-value choice. title: money V2NumberModel: allOf: - $ref: '#/components/schemas/V2TagValue' - type: object properties: kind: type: string description: Discriminator for this shape — always `number` here. enum: - number value: type: number description: >- The typed value. Its JSON type follows `kind`: a number for `number` and `percent`, a `yyyy-MM-dd` string for `date`, a decimal string for `money`, and the captured text for `text`. Omitted when `capturedData` could not be parsed into that type. required: - kind description: >- `kind: number` — a plain numeric amount: a count, an area, a duration. Read `unit` for the qualifier the number was captured with (e.g. months, square feet); the number itself is meaningless without it for most terms. title: number V2NumberRangeModel: allOf: - $ref: '#/components/schemas/V2TagValue' - type: object properties: kind: type: string description: Discriminator for this shape — always `numberRange` here. enum: - numberRange start: type: integer format: int32 description: >- Inclusive start of the range: a `yyyy-MM-dd` string for `dateRange`, an integer for `numberRange`. Omitted together with `end` when `capturedData` could not be split into a parseable pair. end: type: integer format: int32 description: >- Inclusive end of the range: a `yyyy-MM-dd` string for `dateRange`, an integer for `numberRange`. Omitted together with `start` when `capturedData` could not be split into a parseable pair. required: - kind description: >- `kind: numberRange` — an integer range, typically a duration window such as a notice period stated as a span. `unit` names what the bounds count (e.g. `range of days`, `range of months`). Both bounds come from splitting one captured string, so both are omitted together when it could not be split into a parseable pair. title: numberRange V2PercentModel: allOf: - $ref: '#/components/schemas/V2TagValue' - type: object properties: kind: type: string description: Discriminator for this shape — always `percent` here. enum: - percent value: type: number description: >- The typed value. Its JSON type follows `kind`: a number for `number` and `percent`, a `yyyy-MM-dd` string for `date`, a decimal string for `money`, and the captured text for `text`. Omitted when `capturedData` could not be parsed into that type. required: - kind description: >- `kind: percent` — a rate, carried as the percentage itself rather than a fraction: `3` with `unit` `%` means three percent. Produced wherever a numeric value was captured with a percent unit: a tag's own `value` (a pro-rata share, a rent bump) and the `tagComponents` fields that read the captured unit (rate bumps, fee increases). Percent rent schedule entries are also this kind, by construction rather than from a captured unit. `unit` distinguishes the percent flavours — `%`, `% per year`, `% of FMV`, `% increase (annual)` and the rest. title: percent V2TextModel: allOf: - $ref: '#/components/schemas/V2TagValue' - type: object properties: kind: type: string description: Discriminator for this shape — always `text` here. enum: - text value: type: string description: >- The typed value. Its JSON type follows `kind`: a number for `number` and `percent`, a `yyyy-MM-dd` string for `date`, a decimal string for `money`, and the captured text for `text`. Omitted when `capturedData` could not be parsed into that type. required: - kind description: >- `kind: text` — a free-text value, and the fallback kind: any term that is not a date, a number, or a range arrives as text. `value` is the captured text verbatim, so it is always equal to `capturedData`. title: text V2ScheduleModel: type: object properties: kind: type: string description: Which schedule this is; determines the shape of `entries`. enum: - RENT - PERCENT_RENT - ABATEMENT - REFUND - FEE entries: type: array description: The schedule rows, in order. items: $ref: '#/components/schemas/V2ScheduleEntryModel' V2AutoRenewalComponent: allOf: - $ref: '#/components/schemas/V2TagComponentModel' - type: object properties: kind: type: string description: Discriminator for this shape — always `AUTO_RENEWAL` here. enum: - AUTO_RENEWAL advancedNoticePeriod: description: >- Notice required to opt out before an automatic renewal takes effect; this right extends on its own, so the notice stops it rather than exercising it. Shape follows the unit the term was captured with: `number` for a plain count, `date` for a stated deadline, and `numberRange` or `dateRange` when the lease states a window rather than a single figure. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2NumberRangeModel' - $ref: '#/components/schemas/V2DateRangeModel' - $ref: '#/components/schemas/V2TextModel' autoRenewalTerm: description: >- Length of each automatic renewal period. Shape follows the unit the term was captured with: a stated length arrives as `number` — read `unit` for what it counts — and a period the lease words rather than counts arrives as `text`. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2TextModel' autoRenewalPeriods: description: >- Number of automatic renewals, when limited. Shape follows the unit it was captured with: a stated count arrives as `number` with unit `period`, and a count the lease words rather than states arrives as `text`. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2TextModel' autoRenewalRate: description: >- Rent rate for the automatic renewal period, when stated. Shape follows the unit the amount was captured with: a stated amount arrives as `money` with the lease's currency, and an amount the lease describes rather than states arrives as `text`, with the wording in `capturedData`. oneOf: - $ref: '#/components/schemas/V2MoneyModel' - $ref: '#/components/schemas/V2TextModel' autoRenewalRateBump: description: >- Rate increase applied at each automatic renewal, when stated. A percentage arrives as `percent`, carried as the percentage itself; a stated dollar increase arrives as `money` with the lease's currency. oneOf: - $ref: '#/components/schemas/V2PercentModel' - $ref: '#/components/schemas/V2MoneyModel' - $ref: '#/components/schemas/V2TextModel' effectivePeriod: $ref: '#/components/schemas/V2DateRangeModel' description: Date range during which the auto-renewal provision applies. required: - kind description: >- Structured detail for a automatic renewal: the term extends on its own unless the tenant opts out, so the notice period here is the one for opting out rather than for exercising. title: AUTO_RENEWAL V2ContractionComponent: allOf: - $ref: '#/components/schemas/V2TagComponentModel' - type: object properties: kind: type: string description: Discriminator for this shape — always `CONTRACTION` here. enum: - CONTRACTION advancedNoticePeriod: description: >- Notice the tenant must give to exercise the contraction right. Shape follows the unit the term was captured with: `number` for a plain count, `date` for a stated deadline, and `numberRange` or `dateRange` when the lease states a window rather than a single figure. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2NumberRangeModel' - $ref: '#/components/schemas/V2DateRangeModel' - $ref: '#/components/schemas/V2TextModel' contractionFee: description: >- Fee payable on exercising the contraction. Shape follows the unit the amount was captured with: a stated amount arrives as `money` with the lease's currency, and an amount the lease describes rather than states arrives as `text`, with the wording in `capturedData`. oneOf: - $ref: '#/components/schemas/V2MoneyModel' - $ref: '#/components/schemas/V2TextModel' optionEndDate: description: >- Deadline to elect the contraction. Shape follows the unit it was captured with: a stated deadline arrives as `date`, a period the lease measures rather than dates arrives as `number` — read `unit` for what it counts — and a window as `dateRange`. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2DateRangeModel' - $ref: '#/components/schemas/V2TextModel' earlyMoveOutDate: description: >- When the tenant may vacate the contracted space. Shape follows the unit it was captured with: a stated date arrives as `date`, and a period the lease measures rather than dates arrives as `number` — read `unit` for what it counts. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2TextModel' contractionSpace: type: array description: >- Spaces the tenant may give back, in the same shape as a Tag's `applicableSpaces`: suite names matched against `BuildingSpace.suiteNumber` by string, with the `Entire building` and `All spaces` sentinels for whole-building scope. items: $ref: '#/components/schemas/V2SpaceModel' effectivePeriod: $ref: '#/components/schemas/V2DateRangeModel' description: Date range during which the right may be exercised. required: - kind description: >- Structured detail for a contraction right: the tenant's right to give back part of the premises, named in `contractionSpace`. title: CONTRACTION V2EarlyTerminationComponent: allOf: - $ref: '#/components/schemas/V2TagComponentModel' - type: object properties: kind: type: string description: Discriminator for this shape — always `EARLY_TERMINATION` here. enum: - EARLY_TERMINATION advancedNoticePeriod: description: >- Notice the tenant must give to terminate early. Shape follows the unit the term was captured with: `number` for a plain count, `date` for a stated deadline, and `numberRange` or `dateRange` when the lease states a window rather than a single figure. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2NumberRangeModel' - $ref: '#/components/schemas/V2DateRangeModel' - $ref: '#/components/schemas/V2TextModel' terminationFee: description: >- Fee payable on exercising the termination. Shape follows the unit the amount was captured with: a stated amount arrives as `money` with the lease's currency, and an amount the lease describes rather than states arrives as `text`, with the wording in `capturedData`. oneOf: - $ref: '#/components/schemas/V2MoneyModel' - $ref: '#/components/schemas/V2TextModel' optionEndDate: description: >- Deadline to elect the termination. Shape follows the unit it was captured with: a stated deadline arrives as `date`, a period the lease measures rather than dates arrives as `number` — read `unit` for what it counts — and a window as `dateRange`. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2DateRangeModel' - $ref: '#/components/schemas/V2TextModel' earlyMoveOutDate: description: >- When the tenant may vacate on exercising the termination. Shape follows the unit it was captured with: a stated date arrives as `date`, and a period the lease measures rather than dates arrives as `number` — read `unit` for what it counts. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2TextModel' effectivePeriod: $ref: '#/components/schemas/V2DateRangeModel' description: Date range during which the right may be exercised. required: - kind description: >- Structured detail for a early-termination right: the tenant's right to end the lease before its expiration, usually on notice and a fee. title: EARLY_TERMINATION V2ExpansionComponent: allOf: - $ref: '#/components/schemas/V2TagComponentModel' - type: object properties: kind: type: string description: Discriminator for this shape — always `EXPANSION` here. enum: - EXPANSION advancedNoticePeriod: description: >- Notice the tenant must give to exercise the expansion right. Shape follows the unit the term was captured with: `number` for a plain count, `date` for a stated deadline, and `numberRange` or `dateRange` when the lease states a window rather than a single figure. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2NumberRangeModel' - $ref: '#/components/schemas/V2DateRangeModel' - $ref: '#/components/schemas/V2TextModel' acceptancePeriod: description: >- Window to accept once the option is triggered. Shape follows the unit the term was captured with: a stated length arrives as `number` — read `unit` for what it counts — and a period the lease words rather than counts arrives as `text`. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2TextModel' rentalRate: description: >- Rent rate for the expansion space, when stated. Shape follows the unit the rate was captured with: a stated dollar rate arrives as `money` with the lease's currency, and a percentage of fair market value as `percent`. A rate the lease words rather than states — most often fair market value itself — arrives as `text`, with the wording in `capturedData`. A rate the lease leaves to the landlord also arrives as `text`, with `capturedData` set to `landlordDefined`. oneOf: - $ref: '#/components/schemas/V2MoneyModel' - $ref: '#/components/schemas/V2PercentModel' - $ref: '#/components/schemas/V2TextModel' expirationDate: description: >- When the expansion right expires. Shape follows the unit it was captured with: a stated deadline arrives as `date`, and a deadline the lease states in relative terms arrives as `number` — read `unit` for what it counts. Wording that is neither arrives as `text`, and `capturedData` always holds the raw value. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2TextModel' expansionSpace: type: array description: >- Spaces the tenant may take, in the same shape as a Tag's `applicableSpaces`: suite names matched against `BuildingSpace.suiteNumber` by string, with the `Entire building` and `All spaces` sentinels for whole-building scope. items: $ref: '#/components/schemas/V2SpaceModel' effectivePeriod: $ref: '#/components/schemas/V2DateRangeModel' description: Date range during which the right may be exercised. required: - kind description: >- Structured detail for a expansion option: the tenant's right to take additional space, named in `expansionSpace`. title: EXPANSION V2FeeComponent: allOf: - $ref: '#/components/schemas/V2TagComponentModel' - type: object properties: kind: type: string description: Discriminator for this shape — always `FEE` here. enum: - FEE feeAmount: description: >- The fee amount. Shape follows the unit the amount was captured with: a stated amount arrives as `money` with the lease's currency, and an amount the lease describes rather than states arrives as `text`, with the wording in `capturedData`. oneOf: - $ref: '#/components/schemas/V2MoneyModel' - $ref: '#/components/schemas/V2TextModel' feeTerm: description: >- The period the fee runs for. A span of months from commencement arrives as `numberRange` and a pair of dates as `dateRange`, each with `start` and `end` when the captured text parses into a pair. Text that is not a parseable range arrives as `text`, and `capturedData` always holds the raw value. oneOf: - $ref: '#/components/schemas/V2NumberRangeModel' - $ref: '#/components/schemas/V2DateRangeModel' - $ref: '#/components/schemas/V2TextModel' feeIncrease: description: >- Scheduled increase to the fee, when stated. A percentage arrives as `percent`, carried as the percentage itself; a stated dollar increase arrives as `money` with the lease's currency. This is a summary of the escalation: a fee that steps on explicit dates, or steps to new absolute amounts, is only partly expressed here. Read the tag's `schedule` for the authoritative per-period amounts. oneOf: - $ref: '#/components/schemas/V2PercentModel' - $ref: '#/components/schemas/V2MoneyModel' - $ref: '#/components/schemas/V2TextModel' encumberedSpaces: type: array description: >- Spaces the provision burdens; same shape and suite-name matching semantics as `applicableSpaces`. items: $ref: '#/components/schemas/V2SpaceModel' required: - kind description: >- Structured detail for a fee provision: a charge the lease attaches to a right or event, separate from rent. title: FEE V2GenericComponent: allOf: - $ref: '#/components/schemas/V2TagComponentModel' - type: object properties: kind: type: string description: Discriminator for this shape — always `OTHER` here. enum: - OTHER encumberedSpaces: type: array description: >- Spaces the provision burdens; same shape and suite-name matching semantics as `applicableSpaces`. items: $ref: '#/components/schemas/V2SpaceModel' required: - kind description: >- Structured detail for a right Prophia captures without a type-specific shape. The detail lives in the component's own fields — `clause`, the constituent Tags, and the encumbered spaces — rather than in named fields here. title: OTHER V2PurchaseComponent: allOf: - $ref: '#/components/schemas/V2TagComponentModel' - type: object properties: kind: type: string description: Discriminator for this shape — always `PURCHASE` here. enum: - PURCHASE advancedNoticePeriod: description: >- Notice period attached to the purchase right. Shape follows the unit the term was captured with: `number` for a plain count, `date` for a stated deadline, and `numberRange` or `dateRange` when the lease states a window rather than a single figure. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2NumberRangeModel' - $ref: '#/components/schemas/V2DateRangeModel' - $ref: '#/components/schemas/V2TextModel' effectivePeriod: $ref: '#/components/schemas/V2DateRangeModel' description: Date range during which the purchase option may be exercised. required: - kind description: >- Structured detail for a purchase option: the tenant's right to buy the premises. title: PURCHASE V2RenewalComponent: allOf: - $ref: '#/components/schemas/V2TagComponentModel' - type: object properties: kind: type: string description: Discriminator for this shape — always `RENEWAL` here. enum: - RENEWAL renewalPeriodTerm: description: >- Length of each renewal period. A duration, not a date range. Shape follows the unit the term was captured with: a stated length arrives as `number` — read `unit` for what it counts — and a period the lease words rather than counts arrives as `text`. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2TextModel' numberOfAdditionalPeriods: description: >- How many additional periods may be exercised. Shape follows the unit it was captured with: a stated count arrives as `number` with unit `period`, and a count the lease words rather than states arrives as `text`. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2TextModel' advancedNoticePeriod: description: >- Notice the tenant must give to exercise the renewal option. Shape follows the unit the term was captured with: `number` for a plain count, `date` for a stated deadline, and `numberRange` or `dateRange` when the lease states a window rather than a single figure. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2NumberRangeModel' - $ref: '#/components/schemas/V2DateRangeModel' - $ref: '#/components/schemas/V2TextModel' acceptancePeriod: description: >- Window to accept once the option is triggered. Shape follows the unit the term was captured with: a stated length arrives as `number` — read `unit` for what it counts — and a period the lease words rather than counts arrives as `text`. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2TextModel' rentalRate: description: >- Rent rate for the renewal period, when stated. Shape follows the unit the rate was captured with: a stated dollar rate arrives as `money` with the lease's currency, and a percentage of fair market value as `percent`. A rate the lease words rather than states — most often fair market value itself — arrives as `text`, with the wording in `capturedData`. A rate the lease leaves to the landlord also arrives as `text`, with `capturedData` set to `landlordDefined`. oneOf: - $ref: '#/components/schemas/V2MoneyModel' - $ref: '#/components/schemas/V2PercentModel' - $ref: '#/components/schemas/V2TextModel' effectivePeriod: $ref: '#/components/schemas/V2DateRangeModel' description: Date range during which the right may be exercised. required: - kind description: >- Structured detail for a renewal option: the tenant's right to extend the term for one or more further periods on stated notice. title: RENEWAL V2RightOfFirstOfferComponent: allOf: - $ref: '#/components/schemas/V2TagComponentModel' - type: object properties: kind: type: string description: >- Discriminator for this shape — always `RIGHT_OF_FIRST_OFFER` here. enum: - RIGHT_OF_FIRST_OFFER advancedNoticePeriod: description: >- Notice period attached to the offer. Shape follows the unit the term was captured with: `number` for a plain count, `date` for a stated deadline, and `numberRange` or `dateRange` when the lease states a window rather than a single figure. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2NumberRangeModel' - $ref: '#/components/schemas/V2DateRangeModel' - $ref: '#/components/schemas/V2TextModel' acceptancePeriod: description: >- Window the tenant has to accept the offer once made. Shape follows the unit the term was captured with: a stated length arrives as `number` — read `unit` for what it counts — and a period the lease words rather than counts arrives as `text`. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2TextModel' rentalRate: description: >- Rent rate for the offered space, when stated. Shape follows the unit the rate was captured with: a stated dollar rate arrives as `money` with the lease's currency, and a percentage of fair market value as `percent`. A rate the lease words rather than states — most often fair market value itself — arrives as `text`, with the wording in `capturedData`. A rate the lease leaves to the landlord also arrives as `text`, with `capturedData` set to `landlordDefined`. oneOf: - $ref: '#/components/schemas/V2MoneyModel' - $ref: '#/components/schemas/V2PercentModel' - $ref: '#/components/schemas/V2TextModel' expirationDateOfRight: description: >- When the right of first offer expires. Shape follows the unit it was captured with: a stated deadline arrives as `date`, and a deadline the lease states in relative terms arrives as `number` — read `unit` for what it counts. Wording that is neither arrives as `text`, and `capturedData` always holds the raw value. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2TextModel' offeredSpace: type: array description: >- Spaces the right applies to, in the same shape as a Tag's `applicableSpaces`: suite names matched against `BuildingSpace.suiteNumber` by string, with the `Entire building` and `All spaces` sentinels for whole-building scope. items: $ref: '#/components/schemas/V2SpaceModel' oneTimeOrOngoing: type: string description: >- Whether the right can be exercised once or persists through the term, as captured. Free text rather than a fixed set of values. effectivePeriod: $ref: '#/components/schemas/V2DateRangeModel' description: Date range during which the right applies. required: - kind description: >- Structured detail for a right of first offer: before letting the space named in `offeredSpace` to anyone else, the landlord must offer it to this tenant first. title: RIGHT_OF_FIRST_OFFER V2RightOfFirstRefusalComponent: allOf: - $ref: '#/components/schemas/V2TagComponentModel' - type: object properties: kind: type: string description: >- Discriminator for this shape — always `RIGHT_OF_FIRST_REFUSAL` here. enum: - RIGHT_OF_FIRST_REFUSAL advancedNoticePeriod: description: >- Notice period attached to the right. Shape follows the unit the term was captured with: `number` for a plain count, `date` for a stated deadline, and `numberRange` or `dateRange` when the lease states a window rather than a single figure. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2NumberRangeModel' - $ref: '#/components/schemas/V2DateRangeModel' - $ref: '#/components/schemas/V2TextModel' acceptancePeriod: description: >- Window the tenant has to match a third-party offer. Shape follows the unit the term was captured with: a stated length arrives as `number` — read `unit` for what it counts — and a period the lease words rather than counts arrives as `text`. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2TextModel' rentalRate: description: >- Rent rate for the refusal space, when stated. Shape follows the unit the rate was captured with: a stated dollar rate arrives as `money` with the lease's currency, and a percentage of fair market value as `percent`. A rate the lease words rather than states — most often fair market value itself — arrives as `text`, with the wording in `capturedData`. A rate the lease leaves to the landlord also arrives as `text`, with `capturedData` set to `landlordDefined`. oneOf: - $ref: '#/components/schemas/V2MoneyModel' - $ref: '#/components/schemas/V2PercentModel' - $ref: '#/components/schemas/V2TextModel' expirationDateOfRight: description: >- When the right of first refusal expires. Shape follows the unit it was captured with: a stated deadline arrives as `date`, and a deadline the lease states in relative terms arrives as `number` — read `unit` for what it counts. Wording that is neither arrives as `text`, and `capturedData` always holds the raw value. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2TextModel' refusalSpace: type: array description: >- Spaces the right applies to, in the same shape as a Tag's `applicableSpaces`: suite names matched against `BuildingSpace.suiteNumber` by string, with the `Entire building` and `All spaces` sentinels for whole-building scope. items: $ref: '#/components/schemas/V2SpaceModel' oneTimeOrOngoing: type: string description: >- Whether the right can be exercised once or persists through the term, as captured. Free text rather than a fixed set of values. effectivePeriod: $ref: '#/components/schemas/V2DateRangeModel' description: Date range during which the right applies. required: - kind description: >- Structured detail for a right of first refusal: when a third party offers on the space named in `refusalSpace`, the tenant may match it and take the space. title: RIGHT_OF_FIRST_REFUSAL V2TenantImprovementComponent: allOf: - $ref: '#/components/schemas/V2TagComponentModel' - type: object properties: kind: type: string description: Discriminator for this shape — always `TENANT_IMPROVEMENT` here. enum: - TENANT_IMPROVEMENT tiAmount: description: >- Tenant-improvement allowance amount. Shape follows the unit the amount was captured with: a stated amount arrives as `money` with the lease's currency, and an amount the lease describes rather than states arrives as `text`, with the wording in `capturedData`. oneOf: - $ref: '#/components/schemas/V2MoneyModel' - $ref: '#/components/schemas/V2TextModel' tiRemaining: $ref: '#/components/schemas/V2TextModel' description: >- Allowance still unspent, as the lease states it. Always `text`: this term is captured as free wording, and `capturedData` holds the raw value. tiSunset: description: >- Point after which any unspent allowance is forfeited. A stated duration arrives as `number` with its unit, a stated deadline as `date`. oneOf: - $ref: '#/components/schemas/V2NumberModel' - $ref: '#/components/schemas/V2DateModel' - $ref: '#/components/schemas/V2TextModel' required: - kind description: >- Structured detail for a tenant-improvement allowance: money the landlord contributes toward fitting out the space. title: TENANT_IMPROVEMENT V2AmendingTag: type: object description: >- Back-reference built from the Tag's `referenceId`, the shared key of an option-amendment chain. It resolves to different things depending on the Tag holding it: on an option Tag it points at the chain's earlier iteration — the option in a prior Document that this one amends — while on a component Tag it identifies the parent option container the component belongs to. Omitted when a Tag references itself, which is how the first option in a chain is stored. properties: effectiveDate: type: string description: >- Effective date of the referenced Tag — the amended option, or the parent option when this sits on a component. Not the effective date of the Tag carrying this reference. amendedTagId: type: string description: >- Id the Tag's `referenceId` points at: the earlier option this one amends, or the parent option container when this sits on a component Tag. V2PageModel: type: object properties: id: type: string description: Document page id; matches `tagSelections[].docPageId`. pageSequence: type: integer format: int32 description: Position of the page within its document. width: type: integer format: int32 description: >- Page width in the OCR pipeline's native units (typically pixels). Scale a tag citation onto this page with `pixel_x = boundingBox.x * width / 10000`. height: type: integer format: int32 description: >- Page height in the OCR pipeline's native units (typically pixels). Scale a tag citation onto this page with `pixel_y = boundingBox.y * height / 10000`. V2TagValue: type: object description: >- A single captured value. Polymorphic: the `kind` property is the discriminator, and it determines which fields the object carries. - `money` — `value` and `currency` - `number` — `value` - `percent` — `value` - `date` — `value` - `text` — `value` - `dateRange` — `start` and `end` - `numberRange` — `start` and `end` `unit`, `capturedData`, and `ocrText` are common to every kind. A TagValue appears in three positions: a tag's `value`, a field of `tagComponents`, and a field of a schedule entry. A numeric value captured with a percent unit resolves to `percent` both on a tag's own `value` and on the `tagComponents` fields that read the captured unit. Some `tagComponents` fields are fixed to a single kind by definition whatever unit was captured, and schedule entries take their kinds from the schedule rather than from a captured unit. `kind` alone is not enough to interpret a value, because `number` covers durations, areas and plain counts alike. Read `unit` as well. The typed fields are populated by parsing `capturedData`, so they are omitted when the captured text could not be parsed into the kind's type. `capturedData` always holds the raw text and is the fallback when a typed field is missing. discriminator: propertyName: kind properties: unit: type: string description: >- Unit qualifier for the value when the source text carried one (e.g. months, per square foot). capturedData: type: string description: The value as captured during extraction, as text. ocrText: type: string description: Raw source text the value was extracted from. kind: type: string description: >- Discriminator selecting this value's shape; each variant pins its own value. enum: - money - number - percent - date - dateRange - numberRange - text required: - kind V2ScheduleEntryModel: type: object description: >- Entry in a `schedule`. Entries carry no discriminator of their own — the parent `schedule.kind` selects the shape, and each variant is named for the kind that produces it. oneOf: - $ref: '#/components/schemas/V2RentScheduleEntry' - $ref: '#/components/schemas/V2FeeScheduleEntry' - $ref: '#/components/schemas/V2AbatementScheduleEntry' - $ref: '#/components/schemas/V2RefundScheduleEntry' - $ref: '#/components/schemas/V2PercentRentScheduleEntry' properties: sequence: type: integer format: int32 description: 0-indexed ordering within the schedule. V2TagComponentModel: type: object discriminator: propertyName: kind properties: rightStatus: type: string description: >- Status of the option/right itself. Independent of the tag record's `lifecycleStatus` — the two are resolved independently and can disagree. enum: - AVAILABLE - EXERCISED - STRICKEN - DECLINED - EXPIRED - UNKNOWN rightIsStricken: type: string description: >- Indicator the right was stricken from the lease via a Stricken clause; see `rightStatus` for the resolved state. customLabel: type: string description: >- Label denoting the option family this option belongs to. Options with the same `referenceId` should also shared the same `customLabel` effectiveDateOfRight: description: >- When the current version of the right takes effect. Defaults to the parent tag's own effective date, which arrives as `date` with no `unit` because nothing was captured for it; an `