{
  "openapi": "3.1.0",
  "info": {
    "title": "Tendmark Buildings",
    "version": "1",
    "description": "Prepare an editable building-specific route from incomplete facts, preserving reported existing work and coverage questions, then request scope and an indicative fee. Tendmark continues the same brief and its corrections by email; receipt is not a service order or state filing."
  },
  "servers": [
    {
      "url": "https://tendmark.forevenza.com"
    }
  ],
  "paths": {
    "/_c/request": {
      "post": {
        "operationId": "submit_request",
        "summary": "Send a requirement to Tendmark Buildings",
        "description": "Your request is recorded with a reference number. Tendmark will review applicability evidence and existing work, establish data access needs, arrange qualified-role and implementation responsibilities, and develop a building-specific scope and indicative fee. We reply by email when you leave an address, carrying forward this brief and its open questions. Nothing is ordered or committed until you agree terms. Contact details are kept apart from the requirement, while we correspond or do business and for 24 months after, so a later request picks up where it left off; ask us to delete them at any time.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "need"
                ],
                "properties": {
                  "action": {
                    "type": "string",
                    "enum": [
                      "buy",
                      "source",
                      "quote",
                      "verify",
                      "lease",
                      "license",
                      "hire",
                      "retrieve",
                      "convert",
                      "other"
                    ],
                    "description": "What you want done"
                  },
                  "need": {
                    "type": "string",
                    "maxLength": 2000,
                    "description": "The requirement in your own words"
                  },
                  "specifications": {
                    "type": "object",
                    "properties": {
                      "building_address": {
                        "type": "string",
                        "description": "Reported building address, not a verified lookup.",
                        "x-facet": "geography"
                      },
                      "area_sq_ft": {
                        "type": "number",
                        "minimum": 0,
                        "description": "Approximate reported gross area in square feet; omit if unknown.",
                        "x-facet": "quantity"
                      },
                      "area_basis": {
                        "type": "string",
                        "description": "Reported parking basis: Excludes parking, Includes parking or Not sure. Other supplied wording remains for review.",
                        "x-facet": "specification"
                      },
                      "building_use": {
                        "type": "string",
                        "description": "Current reported activity and any mixed-use area breakdown.",
                        "x-facet": "specification"
                      },
                      "situation": {
                        "type": "string",
                        "description": "Owner’s full current account, including existing records, staffing, meters, notices and desired outcome.",
                        "x-facet": "specification"
                      },
                      "proposed_route": {
                        "type": "string",
                        "description": "Preliminary recommendation and rationale; not a compliance determination.",
                        "x-facet": "specification"
                      },
                      "proposed_scope": {
                        "type": "string",
                        "description": "Build on, coordinate and implementation work, including conditional incentive handling.",
                        "x-facet": "specification"
                      },
                      "open_questions": {
                        "type": "string",
                        "description": "Consequential uncertainties and contradictions with assigned next-work owners.",
                        "x-facet": "specification"
                      },
                      "history": {
                        "type": "string",
                        "description": "Superseded assertions, kept distinct from current facts.",
                        "x-facet": "specification"
                      },
                      "prior_reference": {
                        "type": "string",
                        "description": "Earlier returned request reference to which this revision relates; a buyer-supplied link, not proof of acceptance.",
                        "x-facet": "identifier"
                      },
                      "fee_status": {
                        "type": "string",
                        "description": "Fee not yet developed; request a supportable indicative fee separately from incentive eligibility.",
                        "x-facet": "budget"
                      },
                      "continuation_brief": {
                        "type": "string",
                        "description": "Tendmark-owned next work for the continuing application and email engagement, including authority required before binding service execution.",
                        "x-facet": "specification"
                      }
                    },
                    "description": "Details you already know. The business helps resolve missing specifications in the continuing engagement."
                  },
                  "quantity": {
                    "type": "object",
                    "properties": {
                      "amount": {
                        "type": "number"
                      },
                      "unit": {
                        "type": "string"
                      },
                      "per": {
                        "type": "string"
                      }
                    }
                  },
                  "timing": {
                    "type": "object",
                    "properties": {
                      "earliest": {
                        "type": "string"
                      },
                      "latest": {
                        "type": "string"
                      },
                      "recurrence": {
                        "type": "string"
                      },
                      "text": {
                        "type": "string"
                      }
                    }
                  },
                  "geography": {
                    "type": "object",
                    "properties": {
                      "text": {
                        "type": "string"
                      },
                      "country": {
                        "type": "string"
                      },
                      "from": {
                        "type": "string"
                      },
                      "to": {
                        "type": "string"
                      }
                    }
                  },
                  "budget": {
                    "type": "object",
                    "properties": {
                      "amount": {
                        "type": "number"
                      },
                      "currency": {
                        "type": "string",
                        "description": "ISO 4217, default USD"
                      },
                      "per": {
                        "type": "string",
                        "description": "total, unit, month, year, load, ..."
                      }
                    }
                  },
                  "requested_fields": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 30,
                    "description": "Result fields you need"
                  },
                  "contact": {
                    "type": "object",
                    "description": "Optional; stored apart from the requirement, kept while we correspond or do business and for 24 months after, then deleted; you can ask us to delete it sooner",
                    "properties": {
                      "email": {
                        "type": "string"
                      },
                      "name": {
                        "type": "string"
                      },
                      "organization": {
                        "type": "string"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "201": {
            "description": "Recorded, with a reference number"
          },
          "400": {
            "description": "What to fix"
          }
        }
      }
    }
  }
}