{"openapi":"3.1.0","jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","info":{"title":"Hydrometric REST API","version":"1.2","description":"Versioned REST operations. Authentication uses an active hm_live_ account key or the legacy service key, in Authorization: Bearer or x-api-key. No OAuth scope is accepted by the v1 proxy. The configured service limit is 60 requests/minute per key per process, not a distributed quota. API shape versions and calculation engine/schema/data versions are distinct. Request examples use illustrative synthetic inputs and do not establish scientific or release qualification."},"servers":[{"url":"https://www.hydrometric.io"}],"security":[{"bearerKey":[]},{"headerKey":[]}],"x-calculation-stages":[{"id":"descriptors.scale_dplbar","category":"descriptors","summary":"Apply the existing FEG area-amendment rule to DPLBAR, preserving near-unit-area and implausible-scaling refusals.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/descriptors:scaleDplbarWithArea"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_descriptors_scale_dplbar"}},{"id":"descriptors.import","category":"descriptors","summary":"Inspect supplied XML/CD3/CSV bytes using the established parser; no persistence or source-entitlement claim.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/descriptors:parseDescriptorFile","@hydrometric/descriptors:isAssessmentAuthoritativeFormat"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_descriptors_import"}},{"id":"amax.screen","category":"amax","summary":"Validate supplied AMAX records using the core record contract; preserve rejected years and explicitly return the caller-flagged accepted subset.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/types:assertAmaxRecords"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_amax_screen"}},{"id":"descriptors.validate","category":"descriptors","summary":"Validate a supplied complete or partial descriptor vector and resolve family support. Missing descriptors are reported, never invented; characteristic flags require their three source descriptors.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/descriptors:validateDescriptors","@hydrometric/descriptors:resolveStatisticalMethod","@hydrometric/statistical:assessCatchmentFlags"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_descriptors_validate"}},{"id":"amax.diagnostics","category":"amax","summary":"Diagnostics on explicitly screened AMAX values in chronological order; zeros remain in trend testing while unavailable logarithmic/normalised diagnostics carry explicit reasons. No record is automatically excluded.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:grubbsTest","@hydrometric/statistical:mannKendall","@hydrometric/statistical:gringortenPlottingPositions"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_amax_diagnostics"}},{"id":"qmed.amax","category":"qmed","summary":"Median of screened AMAX flows in cubic metres per second.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:qmedFromAmax"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_qmed_amax"}},{"id":"qmed.descriptors","category":"qmed","summary":"Rural descriptor QMED using the explicitly selected 2008 or 2025 equation.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:qmedFromDescriptors2008","@hydrometric/statistical:qmedFromDescriptors2025"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_qmed_descriptors"}},{"id":"qmed.fdc","category":"qmed","summary":"QMED from daily-mean flow-duration statistics and gauged BFI.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:qmedFromFdcStats"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_qmed_fdc"}},{"id":"qmed.urban","category":"urban","summary":"UAF from the correct BFI/urban vintage; targetYear applies to SM2008, SM2025 uses its 2015 baseline.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:urbanAdjustmentFactor","@hydrometric/statistical:urbanAdjustmentFactor2025","@hydrometric/statistical:urbextForYear","@hydrometric/statistical:urbext2015ForYear"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_qmed_urban"}},{"id":"donors.similarity","category":"donors","summary":"Similarity distance using explicit descriptor vintages.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:similarityDistanceMeasure","@hydrometric/statistical:similarityDistanceMeasure2025"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_donors_similarity"}},{"id":"donors.adjust","category":"donors","summary":"Donor adjustment from an explicitly curated set; no external candidate lookup or eligibility claim.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:donorAdjustedQmed","@hydrometric/statistical:donorAdjustedQmed2025"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_donors_adjust"}},{"id":"donors.screen","category":"donors","summary":"Run the shared selected-family metadata and AMAX eligibility checks, with explicit caller curation; source flags remain unverified.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/pipeline:donorMetadataProblem","@hydrometric/pipeline:donorAmaxProblem","@hydrometric/descriptors:resolveStatisticalMethod"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_donors_screen"}},{"id":"pooling.select","category":"pooling","summary":"Form a bounded pooling group using supplied eligibility flags, SDM and moments; subject is separate.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:formPoolingGroup","@hydrometric/statistical:formPoolingGroup2025"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_pooling_select"}},{"id":"pooling.moments","category":"pooling","summary":"Recompute moments for the explicit ordered group, with subject first for enhanced weighting.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:computePooledLMoments2008","@hydrometric/statistical:computePooledLMoments2025","@hydrometric/statistical:computeUngaugedPooledLMoments2025"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_pooling_moments"}},{"id":"moments.sample","category":"moments","summary":"Sample L-moment ratios [L1, L-CV, L-skew, L-kurtosis].","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:lMomentRatios"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_moments_sample"}},{"id":"distribution.fit","category":"fits","summary":"Fit a median-normalised GLO, GEV, PE3 or KAP3 curve.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:fitGLO","@hydrometric/statistical:fitGEV","@hydrometric/statistical:fitPE3","@hydrometric/statistical:fitKAP3"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_distribution_fit"}},{"id":"growth.evaluate","category":"growth","summary":"Fit and evaluate every requested period; no missing-period fallback.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:fitGLO","@hydrometric/statistical:fitGEV","@hydrometric/statistical:fitPE3","@hydrometric/statistical:fitKAP3","@hydrometric/statistical:growthFactor"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_growth_evaluate"}},{"id":"nfy.detect","category":"nfy","summary":"Detect non-flood years without changing the record.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:detectNonFloodYears"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_nfy_detect"}},{"id":"nfy.adjust_glo","category":"nfy","summary":"FEH chapter 19 GLO adjustment; null explicitly means no available adjustment.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:nonFloodAdjustment"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_nfy_adjust_glo"}},{"id":"uncertainty.delta","category":"uncertainty","summary":"GLO/GEV diagonal L-moment delta approximation; null bands are unavailable, not zero.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:growthFactorCI"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_delta"}},{"id":"uncertainty.bootstrap","category":"uncertainty","summary":"Seeded parametric growth bootstrap; preserves engine convergence refusal.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:growthCurveBootstrapCI"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_bootstrap"}},{"id":"uncertainty.gauged","category":"uncertainty","summary":"GLO single-site or enhanced-single-site variance intervals on supplied QMED.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:singleSiteVarianceCI","@hydrometric/statistical:essVarianceCI"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_gauged"}},{"id":"uncertainty.ungauged","category":"uncertainty","summary":"Family-specific FEG v10 or FEH25 tables with explicit unavailability.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:ungaugedDesignFlowCI","@hydrometric/statistical:feh25DesignFlowFSE"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_ungauged"}},{"id":"uncertainty.qmed_fse","category":"uncertainty","summary":"Seeded bootstrap factorial standard error of the supplied AMAX median; zero resampled medians explicitly decline logarithmic uncertainty.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:qmedFseSS","@hydrometric/statistical:mulberry32"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_qmed_fse"}},{"id":"uncertainty.qmed_descriptor","category":"uncertainty","summary":"QMED descriptor intervals using an explicit declared FSE; the default is the installed legacy 1.431 convention, not a FEH25 coverage claim.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:qmedDescriptorCI"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_qmed_descriptor"}},{"id":"uncertainty.effective_record_length","category":"uncertainty","summary":"Equivalent record length from supplied weights and record lengths; zero-weight ungauged subject rows are retained.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:effectiveRecordLength"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_effective_record_length"}},{"id":"uncertainty.pooled_resampling","category":"uncertainty","summary":"Seeded pooled/ESS FSE resampling with explicitly supplied member records and weights.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:pooledBootstrapFse","@hydrometric/statistical:mulberry32"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_pooled_resampling"}},{"id":"nfy.pooled","category":"nfy","summary":"Rebuild selected-family pooling weights and moments after GLO NFY, retaining explicit raw/deurbanised bases and subject identity.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/pipeline:computePooledNfyLMoments"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_nfy_pooled"}},{"id":"pooling.diagnostics","category":"diagnostics","summary":"Seeded heterogeneity, discordancy with supported critical threshold, regional moments and goodness-of-fit for the supplied group.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/statistical:discordancy","@hydrometric/statistical:discordancyCritical","@hydrometric/statistical:regionalWeightedLMoments","@hydrometric/statistical:heterogeneity","@hydrometric/statistical:goodnessOfFit"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_pooling_diagnostics"}},{"id":"design.flows","category":"design","summary":"Canonical family design flows and CI provenance, using supplied QMED and freshly evaluated growth at all requested periods.","status":"available","qualification":"Runs the installed numerical implementation on supplied inputs; does not verify source custody or independently qualify the method.","core":["@hydrometric/pipeline:computeDesignFlows","@hydrometric/descriptors:resolveStatisticalMethod","@hydrometric/statistical:growthFactorCI"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_design_flows"}},{"id":"ddf.import_csv","category":"ddf","summary":"Parse a supplied FEH rainfall CSV; preserves source, model, ARF and domain semantics.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/ddf:parseDDFCSV","@hydrometric/ddf:assertDDFTable"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_ddf_import_csv"}},{"id":"ddf.import_xml","category":"ddf","summary":"Parse every FEH XML rainfall table and retain its explicit model/basis identity; never select the first table as an implicit scientific choice.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/ddf:parseDDFTablesFromXML"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_ddf_import_xml"}},{"id":"ddf.import_stored_feh22","category":"ddf","summary":"Validate supplied stored FEH22-format bytes and report any exact pinned cell repairs. Release/station claims remain unverified.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/ddf:parseStoredFEH22DDFTable"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_ddf_import_stored_feh22"}},{"id":"ddf.lookup","category":"ddf","summary":"Query supplied rainfall tables inside their declared support, retaining frequency/duration/ARF/source metadata.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/ddf:assertDDFTable","@hydrometric/ddf:lookupDDFTable"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_ddf_lookup"}},{"id":"ddf.rmed","category":"ddf","summary":"Interpolate caller-supplied RMED anchors; this is not an FEH22 DDF table or a design rainfall estimate.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/ddf:interpolateRMED"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_ddf_rmed"}},{"id":"rainfall.arf","category":"rainfall","summary":"Compute the published area-duration reduction factor; applying it remains conditional on source arfState.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/refh2:computeARF"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_arf"}},{"id":"rainfall.profile","category":"profile","summary":"FSR symmetric winter/summer profile on an odd interval grid; no ReFH2.3 peak-intensity limiter.","status":"available","qualification":"Published ReFH1/Kjeldsen 2007 component only. Not the licensed ReFH2 engine or a qualified complete design event.","core":["@hydrometric/refh2:generateStormProfile"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_profile"}},{"id":"rainfall_runoff.pdm_loss","category":"rainfall-runoff","summary":"Published PDM loss component with capacity/storage state and interval rainfall depths.","status":"available","qualification":"Published ReFH1/Kjeldsen 2007 component only. Not the licensed ReFH2 engine or a qualified complete design event.","core":["@hydrometric/refh2:computeNetRainfall"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_pdm_loss"}},{"id":"routing.unit_hydrograph","category":"routing","summary":"Sample the published kinked-triangle instantaneous unit hydrograph with an allocation guard.","status":"available","qualification":"Published ReFH1/Kjeldsen 2007 component only. Not the licensed ReFH2 engine or a qualified complete design event.","core":["@hydrometric/refh2:kinkedTriangleGeometry","@hydrometric/refh2:generateIUH"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_routing_unit_hydrograph"}},{"id":"routing.convolve","category":"routing","summary":"Discrete rainfall/IUH convolution, preserving interval-depth and hourly ordinate units.","status":"available","qualification":"Published ReFH1/Kjeldsen 2007 component only. Not the licensed ReFH2 engine or a qualified complete design event.","core":["@hydrometric/refh2:convolve"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_routing_convolve"}},{"id":"routing.baseflow","category":"routing","summary":"Published linear-in-runoff baseflow response from explicit BL/BR/BF0 inputs.","status":"available","qualification":"Published ReFH1/Kjeldsen 2007 component only. Not the licensed ReFH2 engine or a qualified complete design event.","core":["@hydrometric/refh2:computeBaseflow"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_routing_baseflow"}},{"id":"rainfall_runoff.rational","category":"rainfall-runoff","summary":"Rational peak from an explicitly supplied runoff coefficient and event rainfall intensity.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/rational:rationalQ"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_rational"}},{"id":"rainfall_runoff.rational_coefficient","category":"rainfall-runoff","summary":"Installed SPRHOST/land-use runoff coefficient with urban, frequency and storage adjustments; bounded to the tabulated 2–200-year frequency range.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/rational:runoffCoefficientFromSPRHOST","@hydrometric/rational:runoffCoefficientFromLandUse","@hydrometric/rational:modifiedCoefficient"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_rational_coefficient"}},{"id":"rainfall_runoff.rational_design","category":"rainfall-runoff","summary":"Complete existing Rational screening chain with one explicit supplied intensity per 2–200-year event; no substituted RMED rainfall.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/rational:computeDesignPeaks"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_rational_design"}},{"id":"rainfall_runoff.time_of_concentration","category":"rainfall-runoff","summary":"Compare the existing catchment time-of-concentration formulae in hours.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/rational:computeTimeOfConcentration"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_time_of_concentration"}},{"id":"rainfall_runoff.curve_number","category":"rainfall-runoff","summary":"Estimate the existing HOST-to-CN screening mapping from explicit descriptor values.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/scs:estimateCNFromDescriptors"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_curve_number"}},{"id":"rainfall_runoff.scs_loss","category":"rainfall-runoff","summary":"SCS direct runoff depth from explicit CN and initial abstraction convention.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/scs:computeRunoff"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_scs_loss"}},{"id":"routing.scs_unit_hydrograph","category":"routing","summary":"Curvilinear SCS unit hydrograph with the corrected NRCS lag units; triangular path stays disabled.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/scs:buildUnitHydrograph"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_routing_scs_unit_hydrograph"}},{"id":"rainfall_runoff.scs_event","category":"rainfall-runoff","summary":"Existing SCS screening event on supplied rainfall; not adopted FEH design flows.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/scs:computeDesignEvent"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_scs_event"}},{"id":"climate.allowance","category":"climate","summary":"Look up a published England, Welsh Government or SEPA peak river flow allowance with national applicability; no rainfall-to-flow inference.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/climate:getManagementCatchment","@hydrometric/climate:getManagementCatchmentAllowance","@hydrometric/climate:getNationalClimateRegion"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_climate_allowance"}},{"id":"climate.apply","category":"climate","summary":"Apply one explicit allowance to unadjusted peak river flows once; source and base-stage digest remain declared inputs.","status":"available","qualification":"Installed implementation on supplied inputs; no calibration, source entitlement, adopted-flow or external validation claim.","core":["@hydrometric/climate:applyClimateAllowance"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_climate_apply"}},{"id":"hydrograph.import_csv","category":"profile","summary":"Parse and unit-peak-normalise a supplied CSV shape; preserve detected time units, source peak, irregular spacing and truncation/multiple-peak warnings.","status":"available","qualification":"Caller-supplied observations or boundaries; source custody and scientific suitability are not established by a successful computation.","core":["web/export/hydrograph/imported-shape:parseImportedHydrographCsv"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_hydrograph_import_csv"}},{"id":"observations.flow_statistics","category":"observations","summary":"Daily flow-duration, monthly statistics and low-flow indices. FDC drops zeros for its log-axis; low-flow indices retain zeros. Missing-month counts are explicit.","status":"available","qualification":"Caller-supplied observations or boundaries; source custody and scientific suitability are not established by a successful computation.","core":["@hydrometric/statistical:flowDurationCurve","@hydrometric/statistical:monthlyFlowStats","@hydrometric/statistical:lowFlowIndices"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_observations_flow_statistics"}},{"id":"observations.events","category":"profile","summary":"Extract daily windows around caller AMAX peaks and calculate a normalised composite and time-to-peak diagnostics; no sub-daily or design-peak claim.","status":"available","qualification":"Caller-supplied observations or boundaries; source custody and scientific suitability are not established by a successful computation.","core":["@hydrometric/statistical:extractEventHydrographs","@hydrometric/statistical:averageEventHydrograph","@hydrometric/statistical:timeToPeakAnalysis"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_observations_events"}},{"id":"observations.baseflow","category":"observations","summary":"Existing three-pass daily baseflow/recession diagnostic, bounded by both record count and calendar span.","status":"available","qualification":"Caller-supplied observations or boundaries; source custody and scientific suitability are not established by a successful computation.","core":["@hydrometric/statistical:baseflowRecessionDiagnostics"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_observations_baseflow"}},{"id":"amax.seasonality","category":"amax","summary":"Circular peak-date timing/concentration and monthly counts for accepted AMAX records; no homogeneity inference.","status":"available","qualification":"Caller-supplied observations or boundaries; source custody and scientific suitability are not established by a successful computation.","core":["@hydrometric/statistical:circularSeasonalityFromPeakDates","@hydrometric/statistical:amaxSeasonalDistribution"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_amax_seasonality"}},{"id":"hydrograph.scale","category":"profile","summary":"Scale a supplied unit-peak shape to explicit peaks and report the effective baseflow floor; this does not adopt peaks or qualify the shape.","status":"available","qualification":"Caller-supplied observations or boundaries; source custody and scientific suitability are not established by a successful computation.","core":["web/export/hydrograph/series:scaleShapePoints","web/export/hydrograph/series:effectiveBaseflow"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_hydrograph_scale"}},{"id":"climate.spatial_selection","category":"climate","summary":"Intersect an explicit BNG catchment with the installed England management-catchment geometry; preserve fractions and per-scenario conservative contributors.","status":"available","qualification":"Caller-supplied observations or boundaries; source custody and scientific suitability are not established by a successful computation.","core":["@hydrometric/climate:computeManagementCatchmentFractions","@hydrometric/climate:resolveManagementCatchmentSelection","@hydrometric/climate:resolveManagementCatchmentAllowance"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_climate_spatial_selection"}},{"id":"catchment.residual","category":"descriptors","summary":"Derive residual geometry and area-weighted descriptors for supplied WGS84 control/sub-catchments, retaining inherited/clamped-field provenance.","status":"available","qualification":"Caller-supplied observations or boundaries; source custody and scientific suitability are not established by a successful computation.","core":["@hydrometric/multi-catchment:buildResidualCatchment"],"inputSchema":{"$ref":"#/components/schemas/CalculationStageInput_catchment_residual"}},{"id":"source.fetch","category":"source","summary":"Raw frozen/live station, AMAX, daily-flow and candidate retrieval.","status":"existing-workflow","qualification":"Frozen custody is reported only when returned by the repository; live GDF is unverified and not frozen frequency input. Compare its recordSetSha256 across pages. Candidate preflight does not establish final donor/pooling eligibility. Supplied-input stages still never fetch sources.","reason":"MCP get_station_records and GET /api/v1/stations/{stationId}/records share the same bounded operation: station/amax/candidates use the server-selected frozen release; gdf exposes live daily means; release_comparison and daily_flow_diagnostics expose their labelled summaries. Candidate pages carry metadata and suitability/descriptor preflight; read each candidate AMAX separately. No licensed rainfall, assessment, debit or donor/pooling selection is performed. GET /api/v1/analysis/{analysisId} and MCP get_analysis_section remain saved-result reads, not raw source archives.","core":["@hydrometric/pipeline:resolveDataSourceIdentity","pipeline/steps/fetch-data:fetchInitialData","pipeline/steps/fetch-candidates:fetchAndFilterCandidates"],"inputSchema":null},{"id":"ddf.approximate","category":"ddf","summary":"Approximate RMED plus FEH13-anchored growth estimate and legacy Rational rainfall approximation.","status":"experimental-held","qualification":"FEH13-anchored approximation is not FEH22 or audit-grade rainfall.","reason":"Approximate design rainfall requires an explicit provisional workflow and is not activated by the new stage API. Import a supported rainfall table for ddf.lookup, or supply explicit event intensities to rainfall_runoff.rational_design.","core":["@hydrometric/ddf:estimateDesignRainfall","@hydrometric/ddf:rainfallGrowthFactor","@hydrometric/rational:approximateGrowthFactor","@hydrometric/rational:durationScalingFactor","@hydrometric/rational:rainfallIntensityFromRMED"],"inputSchema":null},{"id":"ddf.national","category":"ddf","summary":"Bound national DDF provider and catchment integration.","status":"existing-workflow","qualification":"Caller input cannot assert a production release or activate the beta provider.","reason":"MCP get_ddf_point pairs with POST /api/v1/ddf/point; MCP get_critical_duration pairs with POST /api/v1/ddf/catchment/critical-duration. Both existing pairs retain release, feature, support and domain checks on server-selected artifacts.","core":["@hydrometric/ddf:createSovereignDDFProvider","@hydrometric/ddf:lookupSovereignDDFSurface","@hydrometric/refh2:findNationalCatchmentCriticalDuration"],"inputSchema":null},{"id":"ddf.restricted_compatibility","category":"ddf","summary":"Restricted FEH13 compatibility provider.","status":"license-required","qualification":"No provider activation or license purchase is performed.","reason":"Requires separately authorised bound calibration/source artifacts and license checks; these cannot be supplied as an unverified stage label.","core":["@hydrometric/ddf:createFEH13CompatibilityDDFProvider","@hydrometric/ddf:assertBoundDDFProviderQuery"],"inputSchema":null},{"id":"qmed.sovereign","category":"qmed","summary":"Sovereign/open-native model artifacts and ML comparison lane.","status":"experimental-held","qualification":"Research predictions cannot enter the FEH method lane via calculate_stage.","reason":"Requires immutable server-selected artifact evidence, release gates and separate activation; no model loading or feature-flag changes are exposed here.","core":["@hydrometric/statistical:loadSovereignIndexModelV1","@hydrometric/statistical:qmedFromSovereignIndexV1"],"inputSchema":null},{"id":"distribution.kap4","category":"fits","summary":"Free four-parameter Kappa and legacy KAP fit.","status":"unsupported","qualification":"KAP3 remains callable through distribution.fit/growth.evaluate; no silent KAP alias.","reason":"The current adopted curve contract exposes GLO, GEV, PE3 and fixed-h KAP3. Four-parameter and legacy KAP helpers are not independent supported design-stage families.","core":["@hydrometric/statistical:fitKAP4","@hydrometric/statistical:fitKAP","@hydrometric/statistical:pelkap","@hydrometric/statistical:quakap","@hydrometric/statistical:cdfkap","@hydrometric/statistical:lmrkap"],"inputSchema":null},{"id":"refh1.design_event","category":"rainfall-runoff","summary":"Complete ReFH1 research event and critical duration search.","status":"experimental-held","qualification":"Standalone published profile/loss/routing components are labelled ReFH1 and do not activate a full design event.","reason":"The complete engine uses published ReFH1-Kjeldsen2007 coefficients and remains a research preview. Existing workflow flags and duration/domain checks are not bypassed by a new full-event stage.","core":["@hydrometric/refh2:estimateParameters","@hydrometric/refh2:estimateSeasonalCini","@hydrometric/refh2:estimateBF0","@hydrometric/refh2:estimateAlpha","@hydrometric/refh2:computeSCF","@hydrometric/refh2:computeUrbanNetRainfall","@hydrometric/refh2:runDesignEvent","@hydrometric/refh2:findCriticalDuration"],"inputSchema":null},{"id":"refh2.licensed_event","category":"rainfall-runoff","summary":"Licensed WHS ReFH2 design engine.","status":"license-required","qualification":"Package name refh2 does not identify the shipped coefficients.","reason":"The repository does not contain licensed WHS ReFH2 coefficients. No supported ReFH2 operation or equivalence claim can be provided.","core":["@hydrometric/refh2:getCoefficients"],"inputSchema":null},{"id":"rainfall_runoff.pmf","category":"rainfall-runoff","summary":"PMP, snowmelt, PMF losses/profile/routing and critical season.","status":"experimental-held","qualification":"Conservation checks do not establish UK design suitability.","reason":"PMF coefficients and empirical domains still require independent qualification. This registry does not activate PMF or expose it as a dam-safety design method.","core":["@hydrometric/pmf:estimatePMF","@hydrometric/pmf:pmpPointRainfall","@hydrometric/pmf:computeSnowmelt","@hydrometric/pmf:nestedStormProfile","@hydrometric/pmf:pmfPercentageRunoff"],"inputSchema":null},{"id":"climate.rainfall_or_devolved","category":"climate","summary":"Rainfall climate allowances and rainfall-runoff flow-uplift comparisons.","status":"unsupported","qualification":"Manual factors remain explicit caller declarations in climate.apply.","reason":"Rainfall allowance modelling and the SEPA 30–50 km² rainfall-runoff comparison are not implemented in this registry. England, Welsh and Scottish published peak-river-flow tables are available through climate.allowance; rainfall percentages must not be applied directly to peak flows.","core":["@hydrometric/climate:getClimateAllowance"],"inputSchema":null},{"id":"hydrograph.scale_export","category":"profile","summary":"Adopted saved/run hydrograph suites and model-inflow/simulation-set export.","status":"existing-workflow","qualification":"No assessment or Method Space run/debit is implicit. ReFH1/SCS/imported/proxy shape provenance stays separate from adopted peaks; frozen simulation cases are central-only without a BF0 floor. Minted/legacy keys authenticate v1; MCP retains read scope. Pure supplied-shape scaling remains hydrograph.scale.","reason":"MCP get_design_hydrographs pairs with POST /api/v1/hydrographs/design; export_model_inflows pairs with POST /api/v1/exports/model-inflows; export_simulation_set pairs with POST /api/v1/exports/simulation-set. Each pair calls the same bounded operation and retains explicit saved/run identity, visibility, adopted-period coverage, feature flags and stale source/configuration refusal. The ensemble simulation-set GET/POST reads/writes frozen configuration; it does not itself export files.","core":["web/export/hydrograph/scientific-operations:executeScientificExport","web/export/hydrograph/simulation-set-export:buildSimulationSetExport","web/export/hydrograph/model-inflows:buildModelInflowsExport"],"inputSchema":null},{"id":"routing.network","category":"routing","summary":"River-channel hydraulic network routing and linked-catchment mass balance.","status":"unsupported","qualification":"Unit-hydrograph convolution must not be described as network routing.","reason":"Multi-catchment geometry/descriptor differencing is not a hydraulic routing solver. No Muskingum/SWE/channel-network solver is exported by the calculation core.","core":["@hydrometric/multi-catchment:buildResidualCatchment"],"inputSchema":null},{"id":"routing.scs_triangular","category":"routing","summary":"Legacy triangular SCS unit hydrograph.","status":"unsupported","qualification":"The callable SCS stages preserve the existing curvilinear-only contract.","reason":"The current SCS design-event contract explicitly requires the curvilinear unit hydrograph. The legacy triangular approximation is not an accepted design-event option; use routing.scs_unit_hydrograph or rainfall_runoff.scs_event.","core":["@hydrometric/scs:generateTriangularUH"],"inputSchema":null}],"components":{"securitySchemes":{"bearerKey":{"type":"http","scheme":"bearer","description":"Active account hm_live_ key or configured legacy service key."},"headerKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Alternative transport for the same API keys."}},"schemas":{"GaugedAssessmentRequest":{"type":"object","properties":{"stationId":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991,"description":"NRFA station number, e.g. 39001 (Thames at Kingston)."},"options":{"type":"object","properties":{"descriptors":{"type":"object","properties":{"AREA":{"type":"number"},"SAAR":{"type":"number"},"BFIHOST":{"type":"number"},"DPSBAR":{"type":"number"},"DPLBAR":{"type":"number"},"FARL":{"type":"number"},"FPEXT":{"type":"number"},"URBEXT2000":{"type":"number"},"PROPWET":{"type":"number"},"SPRHOST":{"type":"number"},"LDP":{"type":"number"},"SAAR9120":{"type":"number"},"BFIHOST19":{"type":"number"},"BFIHOST19scaled":{"type":"number"},"URBEXT2015":{"type":"number"},"FARL2015":{"type":"number"},"ALTBAR":{"type":"number"},"RMED_1H":{"type":"number"},"RMED_1D":{"type":"number"},"RMED_2D":{"type":"number"},"URBEXT1990":{"type":"number"}},"additionalProperties":false},"qmedOverride":{"type":"number","exclusiveMinimum":0,"maximum":1000000},"fdcQ5DMF":{"type":"number","exclusiveMinimum":0,"maximum":1000000},"fdcQ10DMF":{"type":"number","exclusiveMinimum":0,"maximum":1000000},"fdcBFI":{"type":"number","minimum":0,"maximum":1},"amaxOverride":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"waterYear":{"type":"integer","minimum":1700,"maximum":2200},"flow":{"type":"number","minimum":0,"maximum":1000000},"rejected":{"type":"boolean"}},"required":["waterYear","flow","rejected"],"additionalProperties":false}},"donorStationIds":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"excludeDonorIds":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"includeDonorIds":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"excludeDonorIds2025":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"includeDonorIds2025":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"maxDonors":{"type":"integer","minimum":1,"maximum":50},"skipDonorAdjustment":{"type":"boolean"},"poolingStationIds":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"excludePoolingIds":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"includePoolingIds":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"targetStationYears":{"type":"integer","minimum":10,"maximum":10000},"skipPooling":{"type":"boolean"},"allowUnsuitableSubjectPooling":{"type":"boolean"},"allowUnsuitableCandidatePooling":{"type":"boolean"},"distributions":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["GLO","GEV","PE3","KAP","KAP3"]}},"returnPeriods":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"number","minimum":2,"maximum":1000}},"nationalClimateRegion":{"description":"Explicit Welsh or Scottish peak-flow policy region. Do not combine with England catchment/basin selection. For Scotland omit epoch and scenario filters: SEPA supplies one total allowance to 2100, subject to catchment-area applicability.","type":"string","enum":["wales-dee","wales-west-wales","wales-severn","scotland-argyll","scotland-clyde","scotland-forth","scotland-north-east","scotland-north-highland","scotland-orkney","scotland-shetland","scotland-solway","scotland-tay","scotland-tweed","scotland-western-isles","scotland-west-highland"]},"managementCatchment":{"type":"string","minLength":1,"maxLength":160},"riverBasin":{"type":"string","minLength":1,"maxLength":160},"managementCatchmentCandidates":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":160},"fraction":{"type":"number","minimum":0,"maximum":1}},"required":["id"],"additionalProperties":false}},"catchmentBoundary":{"type":"object","properties":{"crs":{"type":"string","enum":["EPSG:27700","EPSG:4326"]},"geometry":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"Polygon"},"coordinates":{"minItems":1,"maxItems":10,"type":"array","items":{"minItems":4,"maxItems":1000,"type":"array","items":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"}],"items":false,"minItems":2,"maxItems":2}}}},"required":["type","coordinates"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"MultiPolygon"},"coordinates":{"minItems":1,"maxItems":10,"type":"array","items":{"minItems":1,"maxItems":10,"type":"array","items":{"minItems":4,"maxItems":1000,"type":"array","items":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"}],"items":false,"minItems":2,"maxItems":2}}}}},"required":["type","coordinates"],"additionalProperties":false}]}},"required":["crs","geometry"],"additionalProperties":false},"climateEpochs":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["2020s","2050s","2080s"]}},"climateScenarios":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"string","enum":["central","higherCentral","upperEnd","hPlusPlus"]}},"skipClimateChange":{"type":"boolean"},"skipReFH2":{"type":"boolean"},"skipSCS":{"type":"boolean"},"skipRational":{"type":"boolean"},"refh2Season":{"type":"string","enum":["winter","summer"]},"refh2Cini":{"type":"number","minimum":0,"maximum":10000},"refh2BF0":{"type":"number","minimum":0,"maximum":1000000},"refh2Tp":{"type":"number","minimum":0.1,"maximum":240},"refh2Duration":{"type":"number","minimum":0.25,"maximum":240},"refh2Timestep":{"type":"number","minimum":5,"maximum":60},"donorUrbextThreshold":{"type":"number","minimum":0,"maximum":1},"poolingUrbextThreshold":{"type":"number","minimum":0,"maximum":1},"ddfTable":{"type":"object","properties":{"source":{"type":"string","enum":["FEH_IMPORT","MANUAL","NRFA_RMED"]},"basis":{"type":"string","enum":["point","catchment-average"]},"arfState":{"type":"string","enum":["applied","not-applied"]},"modelVersion":{"type":"string","maxLength":80},"durations":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"number","minimum":0.01,"maximum":8760}},"returnPeriods":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"number","minimum":1,"maximum":10000}},"depths":{"minItems":1,"maxItems":100,"type":"array","items":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"number","minimum":0,"maximum":100000}}}},"required":["source","basis","durations","returnPeriods","depths"],"additionalProperties":false},"allowApproximateDdf":{"type":"boolean"},"applyUEF":{"type":"boolean"},"uefTargetYear":{"type":"integer","minimum":1900,"maximum":2200},"targetYear":{"type":"integer","minimum":1900,"maximum":2200},"applyUrbanAdjustment":{"type":"boolean"},"deurbanisation":{"type":"object","properties":{"subjectSite":{"type":"boolean"},"poolingGroup":{"type":"boolean"}},"additionalProperties":false}},"additionalProperties":false},"idempotencyKey":{"description":"Retry token for this exact request during 24-hour execution retention. Separate from computation and billing identity.","type":"string","pattern":"^[A-Za-z0-9._:-]{1,128}$"}},"required":["stationId"],"additionalProperties":false},"UngaugedAssessmentRequest":{"type":"object","properties":{"idempotencyKey":{"type":"string","pattern":"^[A-Za-z0-9._:-]{1,128}$"},"descriptors":{"type":"object","properties":{"AREA":{"type":["number","null"]},"SAAR":{"type":["number","null"]},"BFIHOST":{"type":["number","null"]},"DPSBAR":{"type":["number","null"]},"DPLBAR":{"type":["number","null"]},"FARL":{"type":["number","null"]},"FPEXT":{"type":["number","null"]},"URBEXT2000":{"type":["number","null"]},"PROPWET":{"type":["number","null"]},"SPRHOST":{"type":["number","null"]},"LDP":{"type":["number","null"]},"SAAR9120":{"type":["number","null"]},"BFIHOST19":{"type":["number","null"]},"BFIHOST19scaled":{"type":["number","null"]},"URBEXT2015":{"type":["number","null"]},"FARL2015":{"type":["number","null"]},"ALTBAR":{"type":["number","null"]}},"additionalProperties":{},"description":"FEH catchment descriptors validated by the same parser as POST /api/v1/estimate."},"options":{"type":"object","properties":{"qmedOverride":{"type":"number","exclusiveMinimum":0,"maximum":1000000},"fdcQ5DMF":{"type":"number","exclusiveMinimum":0,"maximum":1000000},"fdcQ10DMF":{"type":"number","exclusiveMinimum":0,"maximum":1000000},"fdcBFI":{"type":"number","minimum":0,"maximum":1},"amaxOverride":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"object","properties":{"waterYear":{"type":"integer","minimum":1700,"maximum":2200},"flow":{"type":"number","minimum":0,"maximum":1000000},"rejected":{"type":"boolean"}},"required":["waterYear","flow","rejected"],"additionalProperties":false}},"donorStationIds":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"excludeDonorIds":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"includeDonorIds":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"excludeDonorIds2025":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"includeDonorIds2025":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"maxDonors":{"type":"integer","minimum":1,"maximum":50},"skipDonorAdjustment":{"type":"boolean"},"poolingStationIds":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"excludePoolingIds":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"includePoolingIds":{"maxItems":200,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"targetStationYears":{"type":"integer","minimum":10,"maximum":10000},"skipPooling":{"type":"boolean"},"allowUnsuitableSubjectPooling":{"type":"boolean"},"allowUnsuitableCandidatePooling":{"type":"boolean"},"distributions":{"minItems":1,"maxItems":5,"type":"array","items":{"type":"string","enum":["GLO","GEV","PE3","KAP","KAP3"]}},"nationalClimateRegion":{"description":"Explicit Welsh or Scottish peak-flow policy region. Do not combine with England catchment/basin selection. For Scotland omit epoch and scenario filters: SEPA supplies one total allowance to 2100, subject to catchment-area applicability.","type":"string","enum":["wales-dee","wales-west-wales","wales-severn","scotland-argyll","scotland-clyde","scotland-forth","scotland-north-east","scotland-north-highland","scotland-orkney","scotland-shetland","scotland-solway","scotland-tay","scotland-tweed","scotland-western-isles","scotland-west-highland"]},"managementCatchment":{"type":"string","minLength":1,"maxLength":160},"riverBasin":{"type":"string","minLength":1,"maxLength":160},"managementCatchmentCandidates":{"maxItems":50,"type":"array","items":{"type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":160},"fraction":{"type":"number","minimum":0,"maximum":1}},"required":["id"],"additionalProperties":false}},"catchmentBoundary":{"type":"object","properties":{"crs":{"type":"string","enum":["EPSG:27700","EPSG:4326"]},"geometry":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"Polygon"},"coordinates":{"minItems":1,"maxItems":10,"type":"array","items":{"minItems":4,"maxItems":1000,"type":"array","items":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"}],"items":false,"minItems":2,"maxItems":2}}}},"required":["type","coordinates"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"MultiPolygon"},"coordinates":{"minItems":1,"maxItems":10,"type":"array","items":{"minItems":1,"maxItems":10,"type":"array","items":{"minItems":4,"maxItems":1000,"type":"array","items":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"}],"items":false,"minItems":2,"maxItems":2}}}}},"required":["type","coordinates"],"additionalProperties":false}]}},"required":["crs","geometry"],"additionalProperties":false},"climateEpochs":{"minItems":1,"maxItems":3,"type":"array","items":{"type":"string","enum":["2020s","2050s","2080s"]}},"climateScenarios":{"minItems":1,"maxItems":4,"type":"array","items":{"type":"string","enum":["central","higherCentral","upperEnd","hPlusPlus"]}},"skipClimateChange":{"type":"boolean"},"skipReFH2":{"type":"boolean"},"skipSCS":{"type":"boolean"},"skipRational":{"type":"boolean"},"refh2Season":{"type":"string","enum":["winter","summer"]},"refh2Cini":{"type":"number","minimum":0,"maximum":10000},"refh2BF0":{"type":"number","minimum":0,"maximum":1000000},"refh2Tp":{"type":"number","minimum":0.1,"maximum":240},"refh2Duration":{"type":"number","minimum":0.25,"maximum":240},"refh2Timestep":{"type":"number","minimum":5,"maximum":60},"donorUrbextThreshold":{"type":"number","minimum":0,"maximum":1},"poolingUrbextThreshold":{"type":"number","minimum":0,"maximum":1},"ddfTable":{"type":"object","properties":{"source":{"type":"string","enum":["FEH_IMPORT","MANUAL","NRFA_RMED"]},"basis":{"type":"string","enum":["point","catchment-average"]},"arfState":{"type":"string","enum":["applied","not-applied"]},"modelVersion":{"type":"string","maxLength":80},"durations":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"number","minimum":0.01,"maximum":8760}},"returnPeriods":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"number","minimum":1,"maximum":10000}},"depths":{"minItems":1,"maxItems":100,"type":"array","items":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"number","minimum":0,"maximum":100000}}}},"required":["source","basis","durations","returnPeriods","depths"],"additionalProperties":false},"allowApproximateDdf":{"type":"boolean"},"applyUEF":{"type":"boolean"},"uefTargetYear":{"type":"integer","minimum":1900,"maximum":2200},"targetYear":{"type":"integer","minimum":1900,"maximum":2200},"applyUrbanAdjustment":{"type":"boolean"},"deurbanisation":{"type":"object","properties":{"subjectSite":{"type":"boolean"},"poolingGroup":{"type":"boolean"}},"additionalProperties":false}},"additionalProperties":false},"easting":{"type":"number","minimum":0,"maximum":700000,"description":"Site/outlet BNG easting (m), distinct from catchment centroid."},"northing":{"type":"number","minimum":0,"maximum":1300000,"description":"Site/outlet BNG northing (m), distinct from catchment centroid."},"centroid_easting":{"description":"Catchment centroid BNG easting (m). Supply together with centroid_northing; omission defaults to the site point.","type":"number","minimum":0,"maximum":700000},"centroid_northing":{"description":"Catchment centroid BNG northing (m). Supply together with centroid_easting.","type":"number","minimum":0,"maximum":1300000},"return_periods":{"description":"Strictly increasing return periods in years (default: 2,5,10,20,30,50,75,100,200,1000).","minItems":1,"maxItems":20,"type":"array","items":{"type":"number","minimum":2,"maximum":1000}}},"required":["descriptors","easting","northing"],"additionalProperties":false,"dependentRequired":{"centroid_easting":["centroid_northing"],"centroid_northing":["centroid_easting"]}},"AssessmentExecution":{"type":"object","properties":{"runId":{"type":"string","format":"uuid"},"executionId":{"type":"string","format":"uuid"},"computationKey":{"type":["string","null"]},"expiresAt":{"type":"string"},"replayed":{"type":"boolean"},"cached":{"type":"boolean"},"creditConsumed":{"type":"boolean"},"billing":{"type":"object","properties":{"creditConsumed":{"type":"boolean"},"cached":{"type":"boolean"},"usageKey":{"type":["string","null"]}},"required":["creditConsumed","cached","usageKey"],"additionalProperties":true},"provenance":{"type":"object"}},"required":["runId","executionId","computationKey","expiresAt","replayed","cached","creditConsumed","billing","provenance"],"additionalProperties":true},"GaugedAssessmentResponse":{"allOf":[{"$ref":"#/components/schemas/AssessmentExecution"},{"type":"object","properties":{"station":{"type":"object"},"assessmentRoute":{"type":"string"},"qmed":{"type":"object"},"growthCurve":{"type":"object"},"designFlows":{"type":"object"},"climateChange":{"type":["object","null"]},"warnings":{"type":"array","items":{"type":"string"}},"meta":{"type":"object"}},"required":["station","assessmentRoute","qmed","growthCurve","designFlows","climateChange","warnings","meta"],"additionalProperties":true}]},"UngaugedAssessmentResponse":{"allOf":[{"$ref":"#/components/schemas/AssessmentExecution"},{"$ref":"#/components/schemas/EstimateResponse"}]},"DesignHydrographsRequest":{"type":"object","properties":{"analysisId":{"type":"string","minLength":1,"maxLength":200},"runId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"shape":{"type":"string","enum":["refh","scs","imported-csv"]},"timestepMinutes":{"default":15,"type":"number","minimum":5,"maximum":60},"importedCsv":{"type":"string","minLength":1,"maxLength":1048576},"importedFilename":{"type":"string","minLength":1,"maxLength":200},"returnPeriods":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"number","minimum":2,"maximum":1000},"uniqueItems":true,"description":"1–20 strictly increasing periods, 2–1000 years. Each must already exist in the stored adopted result. Omission retains its stored set; new default assessments have ten periods. No interpolation or implicit computation."}},"required":["shape"],"additionalProperties":false,"oneOf":[{"required":["analysisId"],"not":{"required":["runId"]}},{"required":["runId"],"not":{"required":["analysisId"]}}],"allOf":[{"if":{"properties":{"shape":{"const":"imported-csv"}},"required":["shape"]},"then":{"required":["importedCsv"]},"else":{"not":{"anyOf":[{"required":["importedCsv"]},{"required":["importedFilename"]}]}}},{"if":{"properties":{"shape":{"const":"proxy"}},"required":["shape"]},"then":{"required":["analysisId"]}}]},"ModelInflowsRequest":{"type":"object","properties":{"analysisId":{"type":"string","minLength":1,"maxLength":200},"runId":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"},"shape":{"type":"string","enum":["refh","scs","imported-csv","proxy"]},"timestepMinutes":{"default":15,"type":"number","minimum":5,"maximum":60},"importedCsv":{"type":"string","minLength":1,"maxLength":1048576},"importedFilename":{"type":"string","minLength":1,"maxLength":200},"package":{"default":"full","type":"string","enum":["full","tuflow","flood-modeller"]},"format":{"default":"files","type":"string","enum":["files","zip"]},"boundaryLabel":{"default":"inflow","type":"string","minLength":1,"maxLength":80},"includeRunFiles":{"default":true,"type":"boolean"},"returnPeriods":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"number","minimum":2,"maximum":1000},"uniqueItems":true,"description":"1–20 strictly increasing periods, 2–1000 years. Each must already exist in the stored adopted result. Omission retains its stored set; new default assessments have ten periods. No interpolation or implicit computation."},"confidenceLevel":{"anyOf":[{"type":"number","const":68},{"type":"number","const":95}]}},"required":["shape"],"additionalProperties":false,"oneOf":[{"required":["analysisId"],"not":{"required":["runId"]}},{"required":["runId"],"not":{"required":["analysisId"]}}],"allOf":[{"if":{"properties":{"shape":{"const":"imported-csv"}},"required":["shape"]},"then":{"required":["importedCsv"]},"else":{"not":{"anyOf":[{"required":["importedCsv"]},{"required":["importedFilename"]}]}}},{"if":{"properties":{"shape":{"const":"proxy"}},"required":["shape"]},"then":{"required":["analysisId"]}}]},"SimulationSetExportRequest":{"type":"object","properties":{"analysisId":{"type":"string","minLength":1,"maxLength":200},"shape":{"type":"string","enum":["refh","scs","imported-csv","proxy"]},"timestepMinutes":{"default":15,"type":"number","minimum":5,"maximum":60},"importedCsv":{"type":"string","minLength":1,"maxLength":1048576},"importedFilename":{"type":"string","minLength":1,"maxLength":200},"package":{"default":"full","type":"string","enum":["full","tuflow","flood-modeller"]},"format":{"default":"files","type":"string","enum":["files","zip"]},"boundaryLabel":{"default":"inflow","type":"string","minLength":1,"maxLength":80},"includeRunFiles":{"default":true,"type":"boolean"}},"required":["analysisId","shape"],"additionalProperties":false,"allOf":[{"if":{"properties":{"shape":{"const":"imported-csv"}},"required":["shape"]},"then":{"required":["importedCsv"]},"else":{"not":{"anyOf":[{"required":["importedCsv"]},{"required":["importedFilename"]}]}}},{"if":{"properties":{"shape":{"const":"proxy"}},"required":["shape"]},"then":{"required":["analysisId"]}}]},"ExportResultIdentity":{"type":"object","properties":{"analysisId":{"type":"string"},"runId":{"type":"string","format":"uuid"},"sourceSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"adoptedBranchId":{"type":["string","null"]}},"required":["sourceSha256","adoptedBranchId"],"additionalProperties":true},"DesignHydrographsResponse":{"type":"object","properties":{"suite":{"type":"object","properties":{"source":{"type":"object","properties":{"family":{"enum":["refh","scs","imported-csv"]},"label":{"type":"string"},"provenance":{"type":"array","items":{"type":"string"}},"timeToPeakHours":{"type":"number"},"timingCaveat":{"type":"string"}},"required":["family","label","provenance","timeToPeakHours"],"additionalProperties":true},"cases":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string"},"label":{"type":"string"},"returnPeriod":{"type":"number"},"peakFlow":{"type":"number"},"points":{"type":"array","items":{"type":"object","properties":{"t":{"type":"number"},"flow":{"type":"number"}},"required":["t","flow"],"additionalProperties":true}},"climateNote":{"type":"string"}},"required":["key","label","returnPeriod","peakFlow","points"],"additionalProperties":true}},"timestepMinutes":{"type":["number","null"]},"omissions":{"type":"array","items":{"type":"string"}}},"required":["source","cases","omissions"],"additionalProperties":true},"unavailableReason":{"const":null},"resultIdentity":{"$ref":"#/components/schemas/ExportResultIdentity"},"provenance":{"type":"object","properties":{"stationId":{"type":"number"},"assessmentRoute":{"type":"string"},"methodSelection":{"type":["object","null"]},"descriptorOverlay":{"type":["object","null"]},"meta":{"type":"object"},"units":{"type":"object"}},"required":["stationId","assessmentRoute","methodSelection","descriptorOverlay","meta","units"],"additionalProperties":true},"peakSource":{"type":"string"},"creditConsumed":{"const":false}},"required":["suite","unavailableReason","resultIdentity","provenance","peakSource","creditConsumed"],"additionalProperties":true},"ModelInflowsResponse":{"allOf":[{"oneOf":[{"type":"object","properties":{"files":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"},"fileKind":{"enum":["readme","tuflow","flood-modeller"]},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"encoding":{"const":"utf8"}},"required":["path","content","fileKind","sha256","encoding"],"additionalProperties":true}}},"required":["files"],"additionalProperties":true},{"type":"object","properties":{"filename":{"type":"string"},"mimeType":{"const":"application/zip"},"encoding":{"const":"base64"},"data":{"type":"string"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["filename","mimeType","encoding","data","sha256"],"additionalProperties":true}]},{"type":"object","properties":{"shape":{"type":"object","properties":{"methodLabel":{"type":"string"},"provenance":{"type":"array","items":{"type":"string"}},"seriesTimestepMinutes":{"type":["number","null"]}},"required":["methodLabel","provenance","seriesTimestepMinutes"],"additionalProperties":true},"resultIdentity":{"$ref":"#/components/schemas/ExportResultIdentity"},"returnPeriods":{"type":"array","items":{"type":"number"}},"provenance":{"type":"object","properties":{"stationId":{"type":"number"},"assessmentRoute":{"type":"string"},"methodSelection":{"type":["object","null"]},"descriptorOverlay":{"type":["object","null"]},"meta":{"type":"object"},"units":{"type":"object"}},"required":["stationId","assessmentRoute","methodSelection","descriptorOverlay","meta","units"],"additionalProperties":true},"uncertainty":{"type":["string","object"]},"units":{"type":"object","properties":{"time":{"const":"hours"},"flow":{"const":"m³/s"}},"required":["time","flow"],"additionalProperties":true},"creditConsumed":{"const":false}},"required":["shape","resultIdentity","returnPeriods","provenance","uncertainty","units","creditConsumed"],"additionalProperties":true}]},"SimulationSetExportResponse":{"allOf":[{"oneOf":[{"type":"object","properties":{"files":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"content":{"type":"string"},"fileKind":{"enum":["readme","tuflow","flood-modeller"]},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"encoding":{"const":"utf8"}},"required":["path","content","fileKind","sha256","encoding"],"additionalProperties":true}}},"required":["files"],"additionalProperties":true},{"type":"object","properties":{"filename":{"type":"string"},"mimeType":{"const":"application/zip"},"encoding":{"const":"base64"},"data":{"type":"string"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"}},"required":["filename","mimeType","encoding","data","sha256"],"additionalProperties":true}]},{"type":"object","properties":{"simulationSetHash":{"type":"string"},"analysisFingerprint":{"type":"string"},"resultIdentity":{"$ref":"#/components/schemas/ExportResultIdentity"},"caseCount":{"type":"integer","minimum":1,"maximum":20},"returnPeriods":{"type":"array","items":{"type":"number"}},"shapeProvenance":{"type":"array","items":{"type":"string"}},"analysisMeta":{"type":"object"},"creditConsumed":{"const":false}},"required":["simulationSetHash","analysisFingerprint","resultIdentity","caseCount","returnPeriods","shapeProvenance","analysisMeta","creditConsumed"],"additionalProperties":true}]},"EstimateRequest":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://hydrometric.io/schemas/api/v1/estimate.request.json","title":"Hydrometric Estimate Request","type":"object","additionalProperties":false,"required":["descriptors","easting","northing"],"dependentRequired":{"centroid_easting":["centroid_northing"],"centroid_northing":["centroid_easting"]},"properties":{"descriptors":{"type":"object","additionalProperties":false,"required":["AREA","SAAR","BFIHOST","DPSBAR","DPLBAR","LDP","PROPWET","SPRHOST","FARL","FPEXT","URBEXT2000"],"properties":{"AREA":{"type":"number","exclusiveMinimum":0},"SAAR":{"type":"number","exclusiveMinimum":0},"BFIHOST":{"type":"number"},"DPSBAR":{"type":"number"},"DPLBAR":{"type":"number"},"FARL":{"type":"number"},"FPEXT":{"type":"number"},"URBEXT2000":{"type":"number"},"PROPWET":{"type":"number"},"SPRHOST":{"type":"number"},"LDP":{"type":"number"},"SAAR9120":{"type":["number","null"]},"BFIHOST19":{"type":["number","null"]},"BFIHOST19scaled":{"type":["number","null"]},"URBEXT2015":{"type":["number","null"]},"FARL2015":{"type":["number","null"]},"ALTBAR":{"type":["number","null"]}}},"return_periods":{"type":"array","minItems":1,"maxItems":20,"uniqueItems":true,"description":"Return periods in years, strictly increasing. Omitted uses the standard default set. At most 20 periods.","items":{"type":"number","minimum":2,"maximum":1000}},"easting":{"type":"number","minimum":0,"maximum":700000,"description":"Site/outlet BNG easting (metres)."},"northing":{"type":"number","minimum":0,"maximum":1300000,"description":"Site/outlet BNG northing (metres)."},"centroid_easting":{"type":"number","minimum":0,"maximum":700000,"description":"Catchment centroid BNG easting; supply both centroid coordinates or omit both to use the site point."},"centroid_northing":{"type":"number","minimum":0,"maximum":1300000,"description":"Catchment centroid BNG northing; supply both centroid coordinates or omit both to use the site point."}}},"EstimateResponse":{"$schema":"https://json-schema.org/draft/2020-12/schema","$id":"https://hydrometric.io/schemas/api/v1/estimate.response.json","title":"Hydrometric Estimate Response","type":"object","additionalProperties":true,"required":["qmed_m3s","qmed_method","design_flows_m3s","distribution","l_cv","l_skew","pooling_group_size","duration_ms"],"properties":{"qmed_m3s":{"type":"number"},"qmed_method":{"type":"string"},"design_flows_m3s":{"type":"object","additionalProperties":{"type":"number"}},"distribution":{"type":["string","null"]},"l_cv":{"type":["number","null"]},"l_skew":{"type":["number","null"]},"pooling_group_size":{"type":["number","null"]},"warnings":{"type":"array","items":{"type":"string"}},"duration_ms":{"type":"number"},"apiVersion":{"type":"string","description":"1.2 uses the canonical GoF default for selected flow scalars."},"selectedBranch":{"type":["object","null"],"required":["qmedMethod","qmedMethodId","qmedValue","distribution","growthSource","growthMethodId","nfyAdjusted","nfyAdjustmentSource"],"properties":{"qmedMethod":{"type":"string"},"qmedMethodId":{"type":["string","null"]},"qmedValue":{"type":"number"},"distribution":{"type":"string"},"growthSource":{"type":"string"},"growthMethodId":{"type":["string","null"]},"nfyAdjusted":{"type":"boolean"},"nfyAdjustmentSource":{"type":["string","null"]}},"additionalProperties":false},"selectionUnavailableReason":{"type":["string","null"]},"version":{"type":"object","description":"Recorded calculation metadata. Unknown historical values remain null; software is not inferred from the current serializer release.","additionalProperties":false,"required":["engine","schema","peak_flow_dataset","software","computed_at"],"properties":{"engine":{"type":["string","null"]},"schema":{"type":["integer","null"]},"peak_flow_dataset":{"type":["string","null"]},"software":{"type":["string","null"]},"computed_at":{"type":["string","null"]}}},"provenance":{"type":"object","required":["schemaVersion","engineVersion","peakFlowDatasetVersion","dataSource","targetYear","computationKey"],"properties":{"schemaVersion":{"type":["integer","null"]},"engineVersion":{"type":["string","null"]},"peakFlowDatasetVersion":{"type":["string","null"]},"dataSource":{"type":["object","null"]},"targetYear":{"type":["integer","null"]},"computationKey":{"type":["string","null"]}}},"branches":{"type":"array","description":"Every stored QMED × growth branch. recommended marks only the canonical selectedBranch; none is marked if selection is unavailable. Flows are in m³/s.","items":{"type":"object","required":["label","qmed_method","qmed_method_id","growth_method_id","qmed_m3s","growth_source","distribution","nfy_adjusted","nfy_adjustment_source","recommended","flows"],"properties":{"label":{"type":"string"},"qmed_method":{"type":"string"},"qmed_method_id":{"type":["string","null"]},"growth_method_id":{"type":["string","null"]},"qmed_m3s":{"type":"number"},"growth_source":{"type":"string"},"distribution":{"type":"string"},"nfy_adjusted":{"type":"boolean"},"nfy_adjustment_source":{"type":["string","null"]},"recommended":{"type":"boolean"},"flows":{"type":"array","items":{"type":"object"}}}}},"methodSelection":{"type":["object","null"]},"recommendedReason":{"type":"string"},"descriptorValidation":{"type":"object"},"equationSupport":{"type":"object"},"qmedCandidates":{"type":"object"},"designFlows":{"type":"array","items":{"type":"object"}},"pooling":{"type":["object","null"]}}},"Error":{"type":"object","properties":{"error":{"type":"string"},"code":{"type":"string"},"details":{"type":"string"},"missing_descriptors":{"type":"array","items":{"type":"string"}},"unknown_fields":{"type":"array","items":{"type":"string"}}},"required":["error"],"additionalProperties":true},"MethodSpaceRequest":{"type":"object","properties":{"stationId":{"description":"NRFA station number, e.g. 39001 (Thames at Kingston).","type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"analysisId":{"description":"Saved analysis id from list_saved_analyses.","type":"string","minLength":1,"maxLength":256},"descriptors":{"type":"object","properties":{"AREA":{"type":"number","exclusiveMinimum":0},"SAAR":{"type":"number","exclusiveMinimum":0},"BFIHOST":{"type":"number"},"DPSBAR":{"type":"number"},"DPLBAR":{"type":"number"},"FARL":{"type":"number"},"FPEXT":{"type":"number"},"URBEXT2000":{"type":"number"},"PROPWET":{"type":"number"},"SPRHOST":{"type":"number"},"LDP":{"type":"number"},"SAAR9120":{"type":"number"},"BFIHOST19":{"type":"number"},"BFIHOST19scaled":{"type":"number"},"URBEXT2015":{"type":"number"},"FARL2015":{"type":"number"},"ALTBAR":{"type":"number"}},"required":["AREA","SAAR","BFIHOST","DPSBAR","DPLBAR","FARL","FPEXT","URBEXT2000","PROPWET","SPRHOST","LDP"],"additionalProperties":false,"description":"FEH catchment descriptors. Required: AREA (km²), SAAR (mm), BFIHOST, DPSBAR, DPLBAR, LDP, PROPWET, SPRHOST, FARL, FPEXT, URBEXT2000. Optional FEH2025 descriptors (SAAR9120, BFIHOST19, BFIHOST19scaled, URBEXT2015, FARL2015, ALTBAR) unlock the SM2025 equations."},"easting":{"description":"BNG easting (m) — required with descriptors.","type":"number","minimum":0,"maximum":700000},"northing":{"description":"BNG northing (m) — required with descriptors.","type":"number","minimum":0,"maximum":1300000},"compare":{"type":"object","properties":{"qmed_m3s":{"type":"number","exclusiveMinimum":0},"q30_m3s":{"type":"number","exclusiveMinimum":0},"q100_m3s":{"type":"number","exclusiveMinimum":0},"q200_m3s":{"type":"number","exclusiveMinimum":0},"q1000_m3s":{"type":"number","exclusiveMinimum":0},"label":{"description":"Name for the supplied estimate, e.g. \"WINFAP run 2026-08\".","type":"string","maxLength":80}},"additionalProperties":false,"description":"Your own (or a competitor tool's) estimates in m³/s to place inside the method space."},"includeImage":{"description":"Return the figure (default true).","type":"boolean"},"imageDelivery":{"default":"viewer","description":"viewer (default) keeps pixels in private widget metadata; native also returns MCP image content.","type":"string","enum":["viewer","native"]},"qmedRoute":{"description":"Restrict the space to one QMED route before percentiles/compare/figure. Default: \"amax\" when the default route is at-site AMAX (gauged), else \"all\".","type":"string","enum":["all","amax","descriptors"]}},"additionalProperties":false,"oneOf":[{"required":["stationId"],"not":{"anyOf":[{"required":["analysisId"]},{"required":["descriptors"]},{"required":["easting"]},{"required":["northing"]}]}},{"required":["analysisId"],"not":{"anyOf":[{"required":["stationId"]},{"required":["descriptors"]},{"required":["easting"]},{"required":["northing"]}]}},{"required":["descriptors","easting","northing"],"not":{"anyOf":[{"required":["stationId"]},{"required":["analysisId"]}]}}]},"MethodSpaceResponse":{"type":"object","properties":{"source":{"enum":["station","saved-analysis","ungauged"]},"stationId":{"type":["number","null"]},"analysisId":{"type":["string","null"]},"analysisUrl":{"type":["string","null"]},"billing":{"type":"object","properties":{"creditConsumed":{"type":"boolean"},"reason":{"enum":["consumed","exempt","already_paid"]},"creditsRemaining":{"type":["number","null"]},"pricePence":{"type":"integer"}},"required":["creditConsumed","reason","creditsRemaining","pricePence"],"additionalProperties":true},"cached":{"type":"boolean"},"engineVersion":{"type":"string"},"equationSet":{"type":"string"},"methodSpaceFamily":{"type":["string","null"]},"variantCount":{"type":"integer"},"variantCountFiltered":{"type":"integer"},"qmedRouteApplied":{"enum":["all","amax","descriptors"]},"totalEnumerated":{"type":"integer"},"capped":{"type":"boolean"},"default":{"type":"object"},"metrics":{"type":"object"},"named":{"type":"array","items":{"type":"object"}},"compare":{"type":["object","null"]},"figure":{"type":"object","properties":{"format":{"type":["string","null"]},"width":{"type":"number"},"height":{"type":"number"},"caption":{"type":"string"},"url":{"type":["string","null"]},"png_base64":{"type":["string","null"]},"svg":{"type":["string","null"]}},"required":["format","width","height","caption","url","png_base64","svg"],"additionalProperties":true},"note":{"type":"string"}},"required":["source","stationId","analysisId","analysisUrl","billing","cached","engineVersion","equationSet","methodSpaceFamily","variantCount","variantCountFiltered","qmedRouteApplied","totalEnumerated","capped","default","metrics","named","compare","figure","note"],"additionalProperties":true},"NationalDDFPointRequest":{"type":"object","properties":{"easting":{"type":"number","description":"EPSG:27700 easting in metres; the release checks spatial coverage."},"northing":{"type":"number","description":"EPSG:27700 northing in metres; the release checks spatial coverage."},"durationHours":{"type":"number","minimum":0.25,"maximum":240},"returnPeriod":{"type":"number","minimum":2,"maximum":1000,"description":"Return period in years."}},"required":["easting","northing","durationHours","returnPeriod"],"additionalProperties":false},"NationalDDFCriticalDurationRequest":{"type":"object","properties":{"geometry":{"anyOf":[{"type":"object","properties":{"type":{"type":"string","const":"Polygon"},"coordinates":{"minItems":1,"type":"array","items":{"minItems":4,"type":"array","items":{"minItems":2,"type":"array","items":{"type":"number"}}}}},"required":["type","coordinates"],"additionalProperties":{}},{"type":"object","properties":{"type":{"type":"string","const":"MultiPolygon"},"coordinates":{"minItems":1,"type":"array","items":{"minItems":1,"type":"array","items":{"minItems":4,"type":"array","items":{"minItems":2,"type":"array","items":{"type":"number"}}}}}},"required":["type","coordinates"],"additionalProperties":{}}],"description":"EPSG:27700 polygon, with closed non-degenerate rings. Geometry identity validates the operational envelope and total vertex limit; AREA must agree within max(0.01 km², 0.5%)."},"descriptors":{"type":"object","properties":{"AREA":{"type":"number"},"DPLBAR":{"type":"number"},"DPSBAR":{"type":"number"},"LDP":{"type":"number"},"SAAR":{"type":"number"},"BFIHOST":{"type":"number"},"PROPWET":{"type":"number"},"SPRHOST":{"type":"number"},"URBEXT2000":{"type":"number"},"FARL":{"type":"number"},"FPEXT":{"type":"number"},"SAAR9120":{"type":"number"},"BFIHOST19":{"type":"number"},"BFIHOST19scaled":{"type":"number"},"URBEXT2015":{"type":"number"},"FARL2015":{"type":"number"},"RMED_1H":{"type":"number"},"RMED_1D":{"type":"number"},"RMED_2D":{"type":"number"},"ALTBAR":{"type":"number"},"ASPBAR":{"type":"number"},"ASPVAR":{"type":"number"},"DRAINDENS":{"type":"number"},"FPDBAR":{"type":"number"},"FPLOC":{"type":"number"},"SAAR4170":{"type":"number"},"URBEXT1990":{"type":"number"},"URBCONC1990":{"type":"number"},"URBLOC1990":{"type":"number"},"URBCONC2000":{"type":"number"},"URBLOC2000":{"type":"number"}},"required":["AREA","DPLBAR","DPSBAR","LDP","SAAR","BFIHOST","PROPWET","SPRHOST","URBEXT2000","FARL","FPEXT"],"additionalProperties":false,"description":"Authoritative FEH descriptors. The shared descriptor validator also enforces physical ranges and positive ReFH inputs."},"returnPeriod":{"type":"number","minimum":2,"maximum":1000},"season":{"description":"Omitted or null means winter.","anyOf":[{"type":"string","enum":["winter","summer"]},{"type":"null"}]}},"required":["geometry","descriptors","returnPeriod"],"additionalProperties":false},"NationalDDFPointResponse":{"type":"object","properties":{"centralMm":{"type":"number"},"lowerMm":{"type":"number"},"upperMm":{"type":"number"},"drawsMm":{"type":"array","items":{"type":"number"}},"durationHours":{"type":"number"},"returnPeriod":{"type":"number"},"release":{"type":"object","properties":{"releaseId":{"type":"string"},"releaseStatus":{"type":"string"},"manifestSha256":{"type":"string"},"receiptSha256":{"type":"string"},"maturity":{"type":"string"},"certifiedForDesignUse":{"type":"boolean"},"warning":{"type":["string","null"]}},"required":["releaseId","releaseStatus","manifestSha256","receiptSha256"],"additionalProperties":true}},"required":["centralMm","lowerMm","upperMm","drawsMm","durationHours","returnPeriod","release"],"additionalProperties":true},"NationalDDFCriticalDurationResponse":{"type":"object","properties":{"criticalDuration":{"type":"number"},"searchedDurations":{"type":"array","items":{"type":"object"}},"designResult":{"type":"object"},"returnPeriod":{"type":"number"},"season":{"enum":["winter","summer"]},"release":{"type":"object","properties":{"releaseId":{"type":"string"},"releaseStatus":{"type":"string"},"manifestSha256":{"type":"string"},"receiptSha256":{"type":"string"},"maturity":{"type":"string"},"certifiedForDesignUse":{"type":"boolean"},"warning":{"type":["string","null"]}},"required":["releaseId","releaseStatus","manifestSha256","receiptSha256"],"additionalProperties":true}},"required":["criticalDuration","searchedDurations","designResult","returnPeriod","season","release"],"additionalProperties":true},"FullAnalysis":{"type":"object","properties":{"station":{"type":"object"},"qmed":{"type":"object"},"growthCurves":{"type":"object"},"designFlows":{"type":"array","items":{"type":"object"}},"meta":{"type":"object"}},"required":["station","qmed","growthCurves","designFlows","meta"],"additionalProperties":true,"description":"Stored FullAnalysis with its recorded engine/schema/source metadata. Nested calculation fields are additive and retain their recorded analysis schema; reading never recomputes or upgrades history."},"StationRecordsRequest":{"type":"object","properties":{"stationId":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"dataset":{"type":"string","enum":["station","amax","release_comparison","daily_flow_diagnostics","gdf","candidates"]},"offset":{"default":0,"type":"integer","minimum":0,"maximum":1000000},"limit":{"default":100,"type":"integer","minimum":1,"maximum":500}},"required":["stationId","dataset"],"additionalProperties":false},"StationRecordsResponse":{"allOf":[{"type":"object","properties":{"apiVersion":{"const":"1.0"},"stationId":{"type":"integer","minimum":1},"dataset":{"enum":["station","amax","release_comparison","daily_flow_diagnostics","gdf","candidates"]},"source":{"type":"string"},"creditConsumed":{"const":false},"persisted":{"const":false}},"required":["apiVersion","stationId","dataset","source","creditConsumed","persisted"],"additionalProperties":true}],"oneOf":[{"type":"object","properties":{"dataset":{"const":"station"},"station":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"name":{"type":"string"},"descriptors":{"type":"object"},"suitableForQMED":{"type":"boolean"},"suitableForPooling":{"type":"boolean"},"rejectedYears":{"type":"array","items":{"type":"integer"}},"missingDescriptors":{"type":"array","items":{"type":"string"}},"defaultedDescriptors":{"type":"array","items":{"type":"string"}}},"required":["id","name","descriptors","suitableForQMED","suitableForPooling","rejectedYears"],"additionalProperties":true},"datasetVersion":{"type":["string","null"]},"sourceIdentity":{"anyOf":[{"type":"null"},{"type":"object","properties":{"kind":{"enum":["frozen-release","live","user-supplied","unknown"]},"verification":{"enum":["verified","unverified"]},"datasetId":{"type":["string","null"]},"datasetVersion":{"type":["string","null"]},"manifestSha256":{"type":["string","null"]},"contentSha256":{"type":["string","null"]}},"required":["kind","verification","datasetId","datasetVersion","manifestSha256","contentSha256"],"additionalProperties":true}]},"validation":{"type":"object"},"equationSupport":{"type":"object"},"datasetRelease":{"type":["object","null"]}},"required":["dataset","station","datasetVersion","sourceIdentity","validation","equationSupport","datasetRelease"],"additionalProperties":true},{"type":"object","properties":{"dataset":{"const":"amax"},"total":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0,"maximum":1000000},"limit":{"type":"integer","minimum":1,"maximum":500},"nextOffset":{"type":["integer","null"],"minimum":0},"datasetVersion":{"type":["string","null"]},"sourceIdentity":{"anyOf":[{"type":"null"},{"type":"object","properties":{"kind":{"enum":["frozen-release","live","user-supplied","unknown"]},"verification":{"enum":["verified","unverified"]},"datasetId":{"type":["string","null"]},"datasetVersion":{"type":["string","null"]},"manifestSha256":{"type":["string","null"]},"contentSha256":{"type":["string","null"]}},"required":["kind","verification","datasetId","datasetVersion","manifestSha256","contentSha256"],"additionalProperties":true}]},"recordSetSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"records":{"type":"array","items":{"type":"object","properties":{"waterYear":{"type":"integer"},"flow":{"type":"number"},"date":{"type":"string"},"rejected":{"type":"boolean"},"stage":{"type":"number"}},"required":["waterYear","flow","date","rejected"],"additionalProperties":true}},"rejectedYears":{"type":"array","items":{"type":"integer"}},"suitableForQMED":{"type":"boolean"},"suitableForPooling":{"type":"boolean"},"qualification":{"type":"string"},"units":{"type":"object"}},"required":["dataset","total","offset","limit","nextOffset","datasetVersion","sourceIdentity","recordSetSha256","records","rejectedYears","suitableForQMED","suitableForPooling","qualification","units"],"additionalProperties":true},{"type":"object","properties":{"dataset":{"const":"gdf"},"total":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0,"maximum":1000000},"limit":{"type":"integer","minimum":1,"maximum":500},"nextOffset":{"type":["integer","null"],"minimum":0},"sourceIdentity":{"type":"null"},"recordSetSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"records":{"type":"array","items":{"type":"object","properties":{"date":{"type":"string"},"flow":{"type":"number"}},"required":["date","flow"],"additionalProperties":true}},"stationDatasetVersion":{"type":["string","null"]},"stationSourceIdentity":{"anyOf":[{"type":"null"},{"type":"object","properties":{"kind":{"enum":["frozen-release","live","user-supplied","unknown"]},"verification":{"enum":["verified","unverified"]},"datasetId":{"type":["string","null"]},"datasetVersion":{"type":["string","null"]},"manifestSha256":{"type":["string","null"]},"contentSha256":{"type":["string","null"]}},"required":["kind","verification","datasetId","datasetVersion","manifestSha256","contentSha256"],"additionalProperties":true}]},"qualification":{"type":"string"},"units":{"type":"object"}},"required":["dataset","total","offset","limit","nextOffset","sourceIdentity","recordSetSha256","records","stationDatasetVersion","stationSourceIdentity","qualification","units"],"additionalProperties":true},{"type":"object","properties":{"dataset":{"const":"candidates"},"total":{"type":"integer","minimum":0},"offset":{"type":"integer","minimum":0,"maximum":1000000},"limit":{"type":"integer","minimum":1,"maximum":500},"nextOffset":{"type":["integer","null"],"minimum":0},"datasetVersion":{"type":["string","null"]},"sourceIdentity":{"anyOf":[{"type":"null"},{"type":"object","properties":{"kind":{"enum":["frozen-release","live","user-supplied","unknown"]},"verification":{"enum":["verified","unverified"]},"datasetId":{"type":["string","null"]},"datasetVersion":{"type":["string","null"]},"manifestSha256":{"type":["string","null"]},"contentSha256":{"type":["string","null"]}},"required":["kind","verification","datasetId","datasetVersion","manifestSha256","contentSha256"],"additionalProperties":true}]},"records":{"type":"array","items":{"type":"object","properties":{"station":{"type":"object","properties":{"id":{"type":"integer","minimum":1},"name":{"type":"string"},"descriptors":{"type":"object"},"suitableForQMED":{"type":"boolean"},"suitableForPooling":{"type":"boolean"},"rejectedYears":{"type":"array","items":{"type":"integer"}},"missingDescriptors":{"type":"array","items":{"type":"string"}},"defaultedDescriptors":{"type":"array","items":{"type":"string"}}},"required":["id","name","descriptors","suitableForQMED","suitableForPooling","rejectedYears"],"additionalProperties":true},"eligibility":{"type":"object","properties":{"suitableForQMED":{"type":"boolean"},"suitableForPooling":{"type":"boolean"},"descriptors2008":{"type":"object"},"descriptors2025":{"type":"object"}},"required":["suitableForQMED","suitableForPooling","descriptors2008","descriptors2025"],"additionalProperties":true}},"required":["station","eligibility"],"additionalProperties":true}},"qualification":{"type":"string"},"units":{"type":"object"}},"required":["dataset","total","offset","limit","nextOffset","datasetVersion","sourceIdentity","records","qualification","units"],"additionalProperties":true},{"type":"object","properties":{"dataset":{"const":"release_comparison"},"data":{"type":"object","properties":{"current":{"type":"object"},"previous":{"type":"object"}},"required":["current","previous"],"additionalProperties":true},"qualification":{"type":"string"},"units":{"type":"object"}},"required":["dataset","data","qualification","units"],"additionalProperties":true},{"type":"object","properties":{"dataset":{"const":"daily_flow_diagnostics"},"data":{"type":"object"},"eventCount":{"type":"integer"},"offset":{"type":"integer","minimum":0,"maximum":1000000},"limit":{"type":"integer","minimum":1,"maximum":500},"nextOffset":{"type":["integer","null"],"minimum":0},"amaxDatasetVersion":{"type":["string","null"]},"amaxSourceIdentity":{"anyOf":[{"type":"null"},{"type":"object","properties":{"kind":{"enum":["frozen-release","live","user-supplied","unknown"]},"verification":{"enum":["verified","unverified"]},"datasetId":{"type":["string","null"]},"datasetVersion":{"type":["string","null"]},"manifestSha256":{"type":["string","null"]},"contentSha256":{"type":["string","null"]}},"required":["kind","verification","datasetId","datasetVersion","manifestSha256","contentSha256"],"additionalProperties":true}]},"qualification":{"type":"string"},"units":{"type":"object"}},"required":["dataset","data","eventCount","offset","limit","nextOffset","amaxDatasetVersion","amaxSourceIdentity","qualification","units"],"additionalProperties":true}]},"AssessmentRunResponse":{"type":"object","properties":{"apiVersion":{"const":"1.0"},"runId":{"type":"string","format":"uuid"},"executionId":{"type":"string","format":"uuid"},"status":{"const":"completed"},"stationId":{"type":"integer","minimum":0},"computationKey":{"type":["string","null"]},"createdAt":{"type":"string"},"completedAt":{"type":"string"},"expiresAt":{"type":"string"},"resultSha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"analysis":{"$ref":"#/components/schemas/FullAnalysis"},"billing":{"type":"object","properties":{"creditConsumed":{"type":"boolean"},"cached":{"type":"boolean"},"usageKey":{"type":["string","null"]}},"required":["creditConsumed","cached","usageKey"],"additionalProperties":true},"provenance":{"type":"object","properties":{"engineVersion":{"type":["string","null"]},"schemaVersion":{"type":["integer","null"]},"targetYear":{"type":["integer","null"]},"dataSource":{}},"required":["engineVersion","schemaVersion","targetYear","dataSource"],"additionalProperties":true},"creditConsumed":{"const":false}},"required":["apiVersion","runId","executionId","status","stationId","computationKey","createdAt","completedAt","expiresAt","resultSha256","analysis","billing","provenance","creditConsumed"],"additionalProperties":true},"SavedAnalysisResponse":{"type":"object","properties":{"apiVersion":{"const":"1.0"},"analysisId":{"type":"string"},"name":{"type":"string"},"projectId":{"type":["string","null"]},"projectName":{"type":["string","null"]},"savedAt":{"type":"string"},"versionNumber":{"type":["number","null"]},"versionLabel":{"type":["string","null"]},"analysisVersion":{"type":["object","null"]},"recommendedBranchId":{"type":["string","null"],"description":"Raw stored preference. Read assessmentRoutes[].isPreferred for the resolved adopted route."},"climateSelection":{"type":["object","null"]},"analysis":{"$ref":"#/components/schemas/FullAnalysis"},"assessmentRoutes":{"type":"array","items":{"type":"object","properties":{"isPreferred":{"type":"boolean"}}}}},"required":["apiVersion","analysisId","name","projectId","projectName","savedAt","versionNumber","versionLabel","analysisVersion","recommendedBranchId","climateSelection","analysis","assessmentRoutes"],"additionalProperties":true},"AnalysisStatusResponse":{"type":"object","properties":{"apiVersion":{"const":"1.0"},"analysisId":{"type":"string"},"signed":{"type":"boolean"},"primarySignoff":{"type":["object","null"]},"signoffs":{"type":"array","items":{"type":"object"}},"reviews":{"type":"array","items":{"type":"object"}},"comments":{"type":"array","items":{"type":"object"}},"commentSummary":{"type":"object","properties":{"total":{"type":"integer"},"open":{"type":"integer"},"resolved":{"type":"integer"}},"required":["total","open","resolved"],"additionalProperties":true}},"required":["apiVersion","analysisId","signed","primarySignoff","signoffs","reviews","comments","commentSummary"],"additionalProperties":true},"AnalysisAuditRecord":{"type":"object","properties":{"schema":{"type":"string"},"schemaVersion":{"type":"integer"},"generatedAt":{"type":"string"},"software":{"type":"string"},"qmed":{"type":"object"},"analystNotes":{"type":"array","items":{"type":"object"}}},"required":["schema","schemaVersion","software","qmed","analystNotes"],"additionalProperties":true},"CalculationStageEnvelope":{"type":"object","properties":{"stage":{"type":"string","minLength":1,"maxLength":80},"input":{},"source":{"type":"object","properties":{"kind":{"type":"string","enum":["caller-supplied","synthetic"]},"label":{"type":"string","minLength":1,"maxLength":200},"datasetVersion":{"type":"string","minLength":1,"maxLength":100}},"required":["kind","label"],"additionalProperties":false},"targetYear":{"type":"integer","minimum":1900,"maximum":2200}},"required":["stage","input","source","targetYear"],"additionalProperties":false},"CalculationStageResult":{"oneOf":[{"type":"object","properties":{"ok":{"type":"boolean","const":true},"stage":{"type":"string"},"stageDigest":{"type":"string"},"provenance":{"type":"object","properties":{"engineVersion":{"type":"string"},"registryVersion":{"type":"string"},"core":{"type":"array","items":{"type":"string"}},"targetYear":{"type":"number"},"targetYearRole":{"type":"string"},"source":{"type":"object","properties":{"declaration":{"type":"object","properties":{"kind":{"type":"string","enum":["caller-supplied","synthetic"]},"label":{"type":"string","minLength":1,"maxLength":200},"datasetVersion":{"type":"string","minLength":1,"maxLength":100}},"required":["kind","label"],"additionalProperties":false},"verification":{"type":"string","const":"caller-declared-unverified"}},"required":["declaration","verification"]},"inputSha256":{"type":"string"},"options":{},"qualification":{"type":"string"}},"required":["engineVersion","registryVersion","core","targetYear","targetYearRole","source","inputSha256","options","qualification"]},"result":{},"creditConsumed":{"type":"boolean","const":false},"persisted":{"type":"boolean","const":false}},"required":["ok","stage","stageDigest","provenance","result","creditConsumed","persisted"]},{"type":"object","properties":{"ok":{"type":"boolean","const":false},"error":{"type":"object","properties":{"code":{"type":"string","enum":["invalid_input","input_too_large","unknown_stage","unsupported_stage","domain_error","invalid_result","result_too_large"]},"message":{"type":"string"},"stage":{"type":"string"},"issues":{"type":"array","items":{"type":"object","properties":{"path":{"type":"string"},"message":{"type":"string"}},"required":["path","message"]}}},"required":["code","message"]}},"required":["ok","error"]}]},"CalculationStageCatalog":{"type":"object","properties":{"registryVersion":{"type":"string"},"engineVersion":{"type":"string"},"scope":{"type":"string"},"requestSchema":{"type":"object"},"stages":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"category":{"type":"string"},"summary":{"type":"string"},"core":{"type":"array","items":{"type":"string"}},"qualification":{"type":"string"},"status":{"enum":["available","unsupported","license-required","experimental-held","existing-workflow"]},"reason":{"type":"string"},"inputSchema":{"type":["object","null"]}},"required":["id","category","summary","core","qualification","status","inputSchema"],"additionalProperties":true}}},"required":["registryVersion","engineVersion","scope","requestSchema","stages"],"additionalProperties":true},"CalculationStageInput_descriptors_scale_dplbar":{"type":"object","properties":{"areaOld":{"type":"number","minimum":1e-9,"maximum":100000},"areaNew":{"type":"number","minimum":1e-9,"maximum":100000},"dplbarOld":{"type":"number","minimum":1e-9,"maximum":5000}},"required":["areaOld","areaNew","dplbarOld"],"additionalProperties":false},"CalculationStageInput_descriptors_import":{"type":"object","properties":{"text":{"type":"string","minLength":1,"maxLength":200000},"filename":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^\\\\/\\x00-\\x1f]+$"}},"required":["text","filename"],"additionalProperties":false},"CalculationStageInput_amax_screen":{"type":"object","properties":{"records":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"waterYear":{"type":"integer","minimum":1500,"maximum":2200},"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"flow":{"type":"number","minimum":0,"maximum":1000000},"rejected":{"type":"boolean"}},"required":["waterYear","date","flow","rejected"],"additionalProperties":false}}},"required":["records"],"additionalProperties":false},"CalculationStageInput_descriptors_validate":{"type":"object","properties":{"descriptors":{"type":"object","properties":{"AREA":{"type":"number","minimum":1e-9,"maximum":100000},"DPLBAR":{"type":"number","minimum":1e-9,"maximum":5000},"DPSBAR":{"type":"number","minimum":1e-9,"maximum":10000},"LDP":{"type":"number","minimum":1e-9,"maximum":5000},"SAAR":{"type":"number","minimum":1e-9,"maximum":10000},"SAAR9120":{"type":"number","minimum":1e-9,"maximum":10000},"BFIHOST":{"type":"number","minimum":0,"maximum":1},"BFIHOST19":{"type":"number","minimum":0,"maximum":1},"BFIHOST19scaled":{"type":"number","minimum":0,"maximum":1},"PROPWET":{"type":"number","minimum":0,"maximum":1},"SPRHOST":{"type":"number","minimum":0,"maximum":100},"URBEXT2000":{"type":"number","minimum":0,"maximum":1},"URBEXT2015":{"type":"number","minimum":0,"maximum":1},"FARL":{"type":"number","exclusiveMinimum":0,"maximum":1},"FARL2015":{"type":"number","exclusiveMinimum":0,"maximum":1},"FPEXT":{"type":"number","minimum":0,"maximum":1},"ALTBAR":{"type":"number","minimum":0,"maximum":10000},"RMED_1H":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_1D":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_2D":{"type":"number","minimum":1e-9,"maximum":1000000},"version":{"type":"string","enum":["2008","2025"]},"source":{"type":"string","enum":["FEH_WEB_SERVICE","FEH_CD3","NRFA","MANUAL","HYDRO_FAUCET","DERIVED"]},"fetchedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"additionalProperties":false},"preferredMethodId":{"type":"string","enum":["FEH_SM2008","FEH_SM2025"]}},"required":["descriptors","preferredMethodId"],"additionalProperties":false},"CalculationStageInput_amax_diagnostics":{"type":"object","properties":{"flows":{"minItems":5,"maxItems":500,"type":"array","items":{"type":"number","minimum":0,"maximum":1000000}}},"required":["flows"],"additionalProperties":false},"CalculationStageInput_qmed_amax":{"type":"object","properties":{"flows":{"minItems":1,"maxItems":500,"type":"array","items":{"type":"number","minimum":0,"maximum":1000000}}},"required":["flows"],"additionalProperties":false},"CalculationStageInput_qmed_descriptors":{"oneOf":[{"type":"object","properties":{"family":{"type":"string","const":"FEH_SM2008"},"descriptors":{"type":"object","properties":{"AREA":{"type":"number","minimum":1e-9,"maximum":100000},"SAAR":{"type":"number","minimum":1e-9,"maximum":10000},"FARL":{"type":"number","exclusiveMinimum":0,"maximum":1},"BFIHOST":{"type":"number","minimum":0,"maximum":1}},"required":["AREA","SAAR","FARL","BFIHOST"],"additionalProperties":false}},"required":["family","descriptors"],"additionalProperties":false},{"type":"object","properties":{"family":{"type":"string","const":"FEH_SM2025"},"descriptors":{"type":"object","properties":{"AREA":{"type":"number","minimum":1e-9,"maximum":100000},"SAAR9120":{"type":"number","minimum":1e-9,"maximum":10000},"FARL2015":{"type":"number","exclusiveMinimum":0,"maximum":1},"BFIHOST19scaled":{"type":"number","minimum":0,"maximum":1}},"required":["AREA","SAAR9120","FARL2015","BFIHOST19scaled"],"additionalProperties":false}},"required":["family","descriptors"],"additionalProperties":false}]},"CalculationStageInput_qmed_fdc":{"type":"object","properties":{"Q5DMF":{"type":"number","minimum":1e-9,"maximum":1000000},"Q10DMF":{"type":"number","minimum":1e-9,"maximum":1000000},"DPSBAR":{"type":"number","minimum":1e-9,"maximum":1000000},"BFI":{"type":"number","minimum":0,"maximum":1}},"required":["Q5DMF","Q10DMF","DPSBAR","BFI"],"additionalProperties":false},"CalculationStageInput_qmed_urban":{"oneOf":[{"type":"object","properties":{"family":{"type":"string","const":"FEH_SM2008"},"BFIHOST19":{"type":"number","minimum":0,"maximum":1},"URBEXT2000":{"type":"number","minimum":0,"maximum":1}},"required":["family","BFIHOST19","URBEXT2000"],"additionalProperties":false},{"type":"object","properties":{"family":{"type":"string","const":"FEH_SM2025"},"BFIHOST19scaled":{"type":"number","minimum":0,"maximum":1},"URBEXT2015":{"type":"number","minimum":0,"maximum":1}},"required":["family","BFIHOST19scaled","URBEXT2015"],"additionalProperties":false}]},"CalculationStageInput_donors_similarity":{"oneOf":[{"type":"object","properties":{"family":{"type":"string","const":"FEH_SM2008"},"subject":{"type":"object","properties":{"AREA":{"type":"number","minimum":1e-9,"maximum":100000},"SAAR":{"type":"number","minimum":1e-9,"maximum":10000},"FARL":{"type":"number","exclusiveMinimum":0,"maximum":1},"FPEXT":{"type":"number","minimum":0,"maximum":1}},"required":["AREA","SAAR","FARL","FPEXT"],"additionalProperties":false},"candidate":{"type":"object","properties":{"AREA":{"type":"number","minimum":1e-9,"maximum":100000},"SAAR":{"type":"number","minimum":1e-9,"maximum":10000},"FARL":{"type":"number","exclusiveMinimum":0,"maximum":1},"FPEXT":{"type":"number","minimum":0,"maximum":1}},"required":["AREA","SAAR","FARL","FPEXT"],"additionalProperties":false}},"required":["family","subject","candidate"],"additionalProperties":false},{"type":"object","properties":{"family":{"type":"string","const":"FEH_SM2025"},"subject":{"type":"object","properties":{"AREA":{"type":"number","minimum":1e-9,"maximum":100000},"SAAR9120":{"type":"number","minimum":1e-9,"maximum":10000},"FARL2015":{"type":"number","exclusiveMinimum":0,"maximum":1},"BFIHOST19scaled":{"type":"number","exclusiveMinimum":0,"maximum":1},"FPEXT":{"type":"number","minimum":0,"maximum":1}},"required":["AREA","SAAR9120","FARL2015","BFIHOST19scaled","FPEXT"],"additionalProperties":false},"candidate":{"type":"object","properties":{"AREA":{"type":"number","minimum":1e-9,"maximum":100000},"SAAR9120":{"type":"number","minimum":1e-9,"maximum":10000},"FARL2015":{"type":"number","exclusiveMinimum":0,"maximum":1},"BFIHOST19scaled":{"type":"number","exclusiveMinimum":0,"maximum":1},"FPEXT":{"type":"number","minimum":0,"maximum":1}},"required":["AREA","SAAR9120","FARL2015","BFIHOST19scaled","FPEXT"],"additionalProperties":false}},"required":["family","subject","candidate"],"additionalProperties":false}]},"CalculationStageInput_donors_adjust":{"oneOf":[{"type":"object","properties":{"family":{"type":"string","const":"FEH_SM2008"},"subject":{"type":"object","properties":{"qmedDescriptors":{"type":"number","minimum":1e-9,"maximum":1000000},"centroidE":{"type":"number","minimum":0,"maximum":700000},"centroidN":{"type":"number","minimum":0,"maximum":1300000}},"required":["qmedDescriptors","centroidE","centroidN"],"additionalProperties":false},"donors":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"qmedDescriptors":{"type":"number","minimum":1e-9,"maximum":1000000},"centroidE":{"type":"number","minimum":0,"maximum":700000},"centroidN":{"type":"number","minimum":0,"maximum":1300000},"id":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000},"qmedAmax":{"type":"number","minimum":1e-9,"maximum":1000000},"area":{"type":"number","minimum":1e-9,"maximum":1000000},"saar":{"type":"number","minimum":1e-9,"maximum":10000},"bfihost":{"type":"number","minimum":0,"maximum":1},"recordStart":{"type":"integer","minimum":1500,"maximum":2200},"recordEnd":{"type":"integer","minimum":1500,"maximum":2200}},"required":["qmedDescriptors","centroidE","centroidN","id","qmedAmax","area","saar","bfihost","recordStart","recordEnd"],"additionalProperties":false}}},"required":["family","subject","donors"],"additionalProperties":false},{"type":"object","properties":{"family":{"type":"string","const":"FEH_SM2025"},"subject":{"type":"object","properties":{"qmedDescriptors":{"type":"number","minimum":1e-9,"maximum":1000000},"centroidE":{"type":"number","minimum":0,"maximum":700000},"centroidN":{"type":"number","minimum":0,"maximum":1300000},"uaf":{"type":"number","minimum":1e-9,"maximum":10}},"required":["qmedDescriptors","centroidE","centroidN","uaf"],"additionalProperties":false},"donors":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"qmedDescriptors":{"type":"number","minimum":1e-9,"maximum":1000000},"centroidE":{"type":"number","minimum":0,"maximum":700000},"centroidN":{"type":"number","minimum":0,"maximum":1300000},"uaf":{"type":"number","minimum":1e-9,"maximum":10},"id":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000},"qmedAmax":{"type":"number","minimum":1e-9,"maximum":1000000}},"required":["qmedDescriptors","centroidE","centroidN","uaf","id","qmedAmax"],"additionalProperties":false}},"applyUrbanAdjustment":{"default":false,"type":"boolean"}},"required":["family","subject","donors"],"additionalProperties":false}]},"CalculationStageInput_donors_screen":{"type":"object","properties":{"family":{"type":"string","enum":["FEH_SM2008","FEH_SM2025"]},"subjectId":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000},"subjectDescriptors":{"type":"object","properties":{"AREA":{"type":"number","minimum":1e-9,"maximum":100000},"DPLBAR":{"type":"number","minimum":1e-9,"maximum":5000},"DPSBAR":{"type":"number","minimum":1e-9,"maximum":10000},"LDP":{"type":"number","minimum":1e-9,"maximum":5000},"SAAR":{"type":"number","minimum":1e-9,"maximum":10000},"SAAR9120":{"type":"number","minimum":1e-9,"maximum":10000},"BFIHOST":{"type":"number","minimum":0,"maximum":1},"BFIHOST19":{"type":"number","minimum":0,"maximum":1},"BFIHOST19scaled":{"type":"number","minimum":0,"maximum":1},"PROPWET":{"type":"number","minimum":0,"maximum":1},"SPRHOST":{"type":"number","minimum":0,"maximum":100},"URBEXT2000":{"type":"number","minimum":0,"maximum":1},"URBEXT2015":{"type":"number","minimum":0,"maximum":1},"FARL":{"type":"number","exclusiveMinimum":0,"maximum":1},"FARL2015":{"type":"number","exclusiveMinimum":0,"maximum":1},"FPEXT":{"type":"number","minimum":0,"maximum":1},"ALTBAR":{"type":"number","minimum":0,"maximum":10000},"RMED_1H":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_1D":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_2D":{"type":"number","minimum":1e-9,"maximum":1000000},"version":{"type":"string","enum":["2008","2025"]},"source":{"type":"string","enum":["FEH_WEB_SERVICE","FEH_CD3","NRFA","MANUAL","HYDRO_FAUCET","DERIVED"]},"fetchedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["AREA","DPLBAR","DPSBAR","LDP","SAAR","BFIHOST","PROPWET","SPRHOST","URBEXT2000","FARL","FPEXT","version","source","fetchedAt"],"additionalProperties":false},"candidates":{"minItems":1,"maxItems":50,"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000},"centroidEasting":{"type":"number","minimum":0,"maximum":700000},"centroidNorthing":{"type":"number","minimum":0,"maximum":1300000},"descriptors":{"type":"object","properties":{"AREA":{"type":"number","minimum":1e-9,"maximum":100000},"DPLBAR":{"type":"number","minimum":1e-9,"maximum":5000},"DPSBAR":{"type":"number","minimum":1e-9,"maximum":10000},"LDP":{"type":"number","minimum":1e-9,"maximum":5000},"SAAR":{"type":"number","minimum":1e-9,"maximum":10000},"SAAR9120":{"type":"number","minimum":1e-9,"maximum":10000},"BFIHOST":{"type":"number","minimum":0,"maximum":1},"BFIHOST19":{"type":"number","minimum":0,"maximum":1},"BFIHOST19scaled":{"type":"number","minimum":0,"maximum":1},"PROPWET":{"type":"number","minimum":0,"maximum":1},"SPRHOST":{"type":"number","minimum":0,"maximum":100},"URBEXT2000":{"type":"number","minimum":0,"maximum":1},"URBEXT2015":{"type":"number","minimum":0,"maximum":1},"FARL":{"type":"number","exclusiveMinimum":0,"maximum":1},"FARL2015":{"type":"number","exclusiveMinimum":0,"maximum":1},"FPEXT":{"type":"number","minimum":0,"maximum":1},"ALTBAR":{"type":"number","minimum":0,"maximum":10000},"RMED_1H":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_1D":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_2D":{"type":"number","minimum":1e-9,"maximum":1000000},"version":{"type":"string","enum":["2008","2025"]},"source":{"type":"string","enum":["FEH_WEB_SERVICE","FEH_CD3","NRFA","MANUAL","HYDRO_FAUCET","DERIVED"]},"fetchedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["AREA","DPLBAR","DPSBAR","LDP","SAAR","BFIHOST","PROPWET","SPRHOST","URBEXT2000","FARL","FPEXT","version","source","fetchedAt"],"additionalProperties":false},"suitableForQMED":{"type":"boolean"},"amax":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"waterYear":{"type":"integer","minimum":1500,"maximum":2200},"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"flow":{"type":"number","minimum":0,"maximum":1000000},"rejected":{"type":"boolean"}},"required":["waterYear","date","flow","rejected"],"additionalProperties":false}}},"required":["id","centroidEasting","centroidNorthing","descriptors","suitableForQMED","amax"],"additionalProperties":false}},"options":{"default":{"includeDonorIds":[],"excludeDonorIds":[],"donorStationIds":[],"donorUrbextThreshold":0.03},"type":"object","properties":{"includeDonorIds":{"default":[],"maxItems":50,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000}},"excludeDonorIds":{"default":[],"maxItems":50,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000}},"donorStationIds":{"default":[],"maxItems":50,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000}},"donorUrbextThreshold":{"default":0.03,"type":"number","minimum":0,"maximum":1}},"additionalProperties":false}},"required":["family","subjectId","subjectDescriptors","candidates"],"additionalProperties":false},"CalculationStageInput_pooling_select":{"oneOf":[{"type":"object","properties":{"subject":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000},"lCV":{"type":"number","exclusiveMinimum":0,"maximum":1},"lSkew":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1},"lKurtosis":{"type":"number","minimum":-1000000000,"maximum":1000000000},"recordLength":{"type":"integer","minimum":0,"maximum":500},"sdm":{"type":"number","const":0},"urbext2000":{"type":"number","minimum":0,"maximum":1},"urbext2015":{"type":"number","minimum":0,"maximum":1}},"required":["id","lCV","lSkew","lKurtosis","recordLength","sdm","urbext2000"],"additionalProperties":false},"candidates":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000},"lCV":{"type":"number","exclusiveMinimum":0,"maximum":1},"lSkew":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1},"lKurtosis":{"type":"number","minimum":-1000000000,"maximum":1000000000},"recordLength":{"type":"integer","minimum":4,"maximum":500},"sdm":{"type":"number","minimum":0,"maximum":1000},"isSuitableForPooling":{"type":"boolean"},"urbext2000":{"type":"number","minimum":0,"maximum":1},"urbext2015":{"type":"number","minimum":0,"maximum":1}},"required":["id","lCV","lSkew","lKurtosis","recordLength","sdm","isSuitableForPooling","urbext2000"],"additionalProperties":false}},"urbextThreshold":{"default":0.03,"type":"number","minimum":0,"maximum":1},"subjectLCVIsDeurbanised":{"default":false,"type":"boolean"},"family":{"type":"string","const":"FEH_SM2008"},"targetStationYears":{"default":500,"type":"integer","minimum":8,"maximum":10000}},"required":["subject","candidates","family"],"additionalProperties":false},{"type":"object","properties":{"subject":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000},"lCV":{"type":"number","exclusiveMinimum":0,"maximum":1},"lSkew":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1},"lKurtosis":{"type":"number","minimum":-1000000000,"maximum":1000000000},"recordLength":{"type":"integer","minimum":0,"maximum":500},"sdm":{"type":"number","const":0},"urbext2000":{"type":"number","minimum":0,"maximum":1},"urbext2015":{"type":"number","minimum":0,"maximum":1}},"required":["id","lCV","lSkew","lKurtosis","recordLength","sdm","urbext2000"],"additionalProperties":false},"candidates":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"id":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000},"lCV":{"type":"number","exclusiveMinimum":0,"maximum":1},"lSkew":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1},"lKurtosis":{"type":"number","minimum":-1000000000,"maximum":1000000000},"recordLength":{"type":"integer","minimum":4,"maximum":500},"sdm":{"type":"number","minimum":0,"maximum":1000},"isSuitableForPooling":{"type":"boolean"},"urbext2000":{"type":"number","minimum":0,"maximum":1},"urbext2015":{"type":"number","minimum":0,"maximum":1}},"required":["id","lCV","lSkew","lKurtosis","recordLength","sdm","isSuitableForPooling","urbext2000"],"additionalProperties":false}},"urbextThreshold":{"default":0.03,"type":"number","minimum":0,"maximum":1},"subjectLCVIsDeurbanised":{"default":false,"type":"boolean"},"family":{"type":"string","const":"FEH_SM2025"},"targetStationYears":{"default":800,"type":"integer","minimum":8,"maximum":10000}},"required":["subject","candidates","family"],"additionalProperties":false}]},"CalculationStageInput_pooling_moments":{"oneOf":[{"type":"object","properties":{"family":{"type":"string","const":"FEH_SM2008"},"stations":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"lCV":{"type":"number","exclusiveMinimum":0,"maximum":1},"lSkew":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1},"recordLength":{"type":"integer","minimum":4,"maximum":500},"sdm":{"type":"number","minimum":0,"maximum":1000},"urbext":{"type":"number","minimum":0,"maximum":1}},"required":["lCV","lSkew","recordLength","sdm","urbext"],"additionalProperties":false}},"urbanAdjustment":{"type":"object","properties":{"lCVFactor":{"type":"number","minimum":1e-9,"maximum":10},"lSkewFactor":{"type":"number","minimum":1e-9,"maximum":10}},"required":["lCVFactor","lSkewFactor"],"additionalProperties":false}},"required":["family","stations","urbanAdjustment"],"additionalProperties":false},{"type":"object","properties":{"family":{"type":"string","const":"FEH_SM2025"},"stations":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"lCV":{"type":"number","exclusiveMinimum":0,"maximum":1},"lSkew":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1},"recordLength":{"type":"integer","minimum":4,"maximum":500},"sdm":{"type":"number","minimum":0,"maximum":1000},"urbext":{"type":"number","minimum":0,"maximum":1}},"required":["lCV","lSkew","recordLength","sdm","urbext"],"additionalProperties":false}},"subjectUrbext2015":{"type":"number","minimum":0,"maximum":1},"mode":{"type":"string","enum":["enhanced-single-site","ungauged"]},"subjectLCVIsDeurbanised":{"default":false,"type":"boolean"}},"required":["family","stations","subjectUrbext2015","mode"],"additionalProperties":false}]},"CalculationStageInput_moments_sample":{"type":"object","properties":{"flows":{"minItems":4,"maxItems":500,"type":"array","items":{"type":"number","minimum":0,"maximum":1000000}}},"required":["flows"],"additionalProperties":false},"CalculationStageInput_distribution_fit":{"type":"object","properties":{"distribution":{"type":"string","enum":["GLO","GEV","PE3","KAP3"]},"lCV":{"type":"number","exclusiveMinimum":0,"maximum":1},"lSkew":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1}},"required":["distribution","lCV","lSkew"],"additionalProperties":false},"CalculationStageInput_growth_evaluate":{"type":"object","properties":{"distribution":{"type":"string","enum":["GLO","GEV","PE3","KAP3"]},"lCV":{"type":"number","exclusiveMinimum":0,"maximum":1},"lSkew":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1},"returnPeriods":{"default":[2,5,10,20,30,50,75,100,200,1000],"minItems":1,"maxItems":20,"type":"array","items":{"type":"number","minimum":2,"maximum":1000}}},"required":["distribution","lCV","lSkew"],"additionalProperties":false},"CalculationStageInput_nfy_detect":{"type":"object","properties":{"flows":{"minItems":4,"maxItems":500,"type":"array","items":{"type":"number","minimum":0,"maximum":1000000}}},"required":["flows"],"additionalProperties":false},"CalculationStageInput_nfy_adjust_glo":{"type":"object","properties":{"flows":{"minItems":4,"maxItems":500,"type":"array","items":{"type":"number","minimum":0,"maximum":1000000}},"distribution":{"type":"string","const":"GLO"}},"required":["flows","distribution"],"additionalProperties":false},"CalculationStageInput_uncertainty_delta":{"type":"object","properties":{"distribution":{"type":"string","enum":["GLO","GEV","PE3","KAP3"]},"lCV":{"type":"number","exclusiveMinimum":0,"maximum":1},"lSkew":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1},"returnPeriods":{"default":[2,5,10,20,30,50,75,100,200,1000],"minItems":1,"maxItems":20,"type":"array","items":{"type":"number","minimum":2,"maximum":1000}},"effectiveRecordLength":{"type":"integer","minimum":4,"maximum":500},"confidenceLevel":{"default":0.95,"anyOf":[{"type":"number","const":0.9},{"type":"number","const":0.95},{"type":"number","const":0.99}]}},"required":["distribution","lCV","lSkew","effectiveRecordLength"],"additionalProperties":false},"CalculationStageInput_uncertainty_bootstrap":{"type":"object","properties":{"distribution":{"type":"string","enum":["GLO","GEV","PE3","KAP3"]},"lCV":{"type":"number","exclusiveMinimum":0,"maximum":1},"lSkew":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1},"returnPeriods":{"default":[2,5,10,20,30,50,75,100,200,1000],"minItems":1,"maxItems":20,"type":"array","items":{"type":"number","minimum":2,"maximum":1000}},"effectiveRecordLength":{"type":"integer","minimum":5,"maximum":500},"replicates":{"default":5000,"type":"integer","minimum":100,"maximum":5000},"seed":{"default":19937,"type":"integer","minimum":0,"maximum":4294967295}},"required":["distribution","lCV","lSkew","effectiveRecordLength"],"additionalProperties":false},"CalculationStageInput_uncertainty_gauged":{"type":"object","properties":{"distribution":{"type":"string","const":"GLO"},"lCV":{"type":"number","exclusiveMinimum":0,"maximum":1},"lSkew":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1},"returnPeriods":{"default":[2,5,10,20,30,50,75,100,200,1000],"minItems":1,"maxItems":20,"type":"array","items":{"type":"number","minimum":2,"maximum":1000}},"qmed":{"type":"number","minimum":1e-9,"maximum":1000000},"n":{"type":"integer","minimum":4,"maximum":500},"method":{"type":"string","enum":["single-site","enhanced-single-site"]},"atSiteLCV":{"type":"number","exclusiveMinimum":0,"maximum":1}},"required":["distribution","lCV","lSkew","qmed","n","method","atSiteLCV"],"additionalProperties":false},"CalculationStageInput_uncertainty_ungauged":{"type":"object","properties":{"family":{"type":"string","enum":["FEH_SM2008","FEH_SM2025"]},"returnPeriods":{"default":[2,5,10,20,30,50,75,100,200,1000],"minItems":1,"maxItems":20,"type":"array","items":{"type":"number","minimum":2,"maximum":1000}},"urbext":{"type":"number","minimum":0,"maximum":1},"donorCount":{"type":"integer","minimum":0,"maximum":50}},"required":["family","urbext","donorCount"],"additionalProperties":false},"CalculationStageInput_uncertainty_qmed_fse":{"type":"object","properties":{"flows":{"minItems":4,"maxItems":500,"type":"array","items":{"type":"number","minimum":0,"maximum":1000000}},"replicates":{"default":500,"type":"integer","minimum":100,"maximum":5000},"seed":{"default":19937,"type":"integer","minimum":0,"maximum":4294967295}},"required":["flows"],"additionalProperties":false},"CalculationStageInput_uncertainty_qmed_descriptor":{"type":"object","properties":{"qmed":{"type":"number","minimum":0,"maximum":1000000},"fse":{"default":1.431,"type":"number","minimum":1,"maximum":10}},"required":["qmed"],"additionalProperties":false},"CalculationStageInput_uncertainty_effective_record_length":{"type":"object","properties":{"weights":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"number","minimum":0,"maximum":1000000}},"recordLengths":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"integer","minimum":0,"maximum":500}}},"required":["weights","recordLengths"],"additionalProperties":false},"CalculationStageInput_uncertainty_pooled_resampling":{"type":"object","properties":{"members":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"flows":{"minItems":4,"maxItems":200,"type":"array","items":{"type":"number","minimum":0,"maximum":1000000}},"lcvWeight":{"type":"number","minimum":0,"maximum":1000000},"lskewWeight":{"type":"number","minimum":0,"maximum":1000000}},"required":["flows","lcvWeight","lskewWeight"],"additionalProperties":false}},"subjectFlows":{"minItems":4,"maxItems":200,"type":"array","items":{"type":"number","minimum":0,"maximum":1000000}},"returnPeriods":{"default":[2,5,10,20,30,50,75,100,200,1000],"minItems":1,"maxItems":20,"type":"array","items":{"type":"number","minimum":2,"maximum":1000}},"replicates":{"default":200,"type":"integer","minimum":100,"maximum":500},"seed":{"default":19937,"type":"integer","minimum":0,"maximum":4294967295}},"required":["members","subjectFlows"],"additionalProperties":false},"CalculationStageInput_nfy_pooled":{"type":"object","properties":{"stations":{"minItems":1,"maxItems":200,"type":"array","items":{"type":"object","properties":{"lCV":{"type":"number","exclusiveMinimum":0,"maximum":1},"lSkew":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1},"recordLength":{"type":"integer","minimum":4,"maximum":500},"sdm":{"type":"number","minimum":0,"maximum":1000},"urbext":{"type":"number","minimum":0,"maximum":1},"id":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000},"lMomentBasis":{"type":"string","enum":["raw","deurbanised"]},"nonFloodLCV":{"type":"number","exclusiveMinimum":0,"maximum":1},"nonFloodLSkew":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1},"nonFloodMomentBasis":{"type":"string","enum":["raw","deurbanised"]}},"required":["lCV","lSkew","recordLength","sdm","urbext","id","lMomentBasis"],"additionalProperties":false}},"options":{"type":"object","properties":{"equationFamily":{"type":"string","enum":["SM2008","SM2025"]},"subjectId":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000},"subjectMomentBasis":{"type":"string","enum":["raw","deurbanised"]},"urbanAdjustment":{"type":"object","properties":{"lCVFactor":{"type":"number","minimum":1e-9,"maximum":10},"lSkewFactor":{"type":"number","minimum":1e-9,"maximum":10}},"required":["lCVFactor","lSkewFactor"],"additionalProperties":false}},"required":["equationFamily","subjectId","subjectMomentBasis","urbanAdjustment"],"additionalProperties":false}},"required":["stations","options"],"additionalProperties":false},"CalculationStageInput_pooling_diagnostics":{"type":"object","properties":{"stations":{"minItems":3,"maxItems":30,"type":"array","items":{"type":"object","properties":{"lCV":{"type":"number","exclusiveMinimum":0,"maximum":1},"lSkew":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1},"lKurtosis":{"type":"number","minimum":-1000000000,"maximum":1000000000},"recordLength":{"type":"integer","minimum":4,"maximum":500}},"required":["lCV","lSkew","lKurtosis","recordLength"],"additionalProperties":false}},"distribution":{"type":"string","enum":["GLO","GEV","PE3","KAP3"]},"simulations":{"default":500,"type":"integer","minimum":100,"maximum":500},"seed":{"default":19937,"type":"integer","minimum":0,"maximum":4294967295}},"required":["stations","distribution"],"additionalProperties":false},"CalculationStageInput_design_flows":{"type":"object","properties":{"distribution":{"type":"string","enum":["GLO","GEV","PE3","KAP3"]},"lCV":{"type":"number","exclusiveMinimum":0,"maximum":1},"lSkew":{"type":"number","exclusiveMinimum":-1,"exclusiveMaximum":1},"returnPeriods":{"default":[2,5,10,20,30,50,75,100,200,1000],"minItems":1,"maxItems":20,"type":"array","items":{"type":"number","minimum":2,"maximum":1000}},"descriptors":{"type":"object","properties":{"AREA":{"type":"number","minimum":1e-9,"maximum":100000},"DPLBAR":{"type":"number","minimum":1e-9,"maximum":5000},"DPSBAR":{"type":"number","minimum":1e-9,"maximum":10000},"LDP":{"type":"number","minimum":1e-9,"maximum":5000},"SAAR":{"type":"number","minimum":1e-9,"maximum":10000},"SAAR9120":{"type":"number","minimum":1e-9,"maximum":10000},"BFIHOST":{"type":"number","minimum":0,"maximum":1},"BFIHOST19":{"type":"number","minimum":0,"maximum":1},"BFIHOST19scaled":{"type":"number","minimum":0,"maximum":1},"PROPWET":{"type":"number","minimum":0,"maximum":1},"SPRHOST":{"type":"number","minimum":0,"maximum":100},"URBEXT2000":{"type":"number","minimum":0,"maximum":1},"URBEXT2015":{"type":"number","minimum":0,"maximum":1},"FARL":{"type":"number","exclusiveMinimum":0,"maximum":1},"FARL2015":{"type":"number","exclusiveMinimum":0,"maximum":1},"FPEXT":{"type":"number","minimum":0,"maximum":1},"ALTBAR":{"type":"number","minimum":0,"maximum":10000},"RMED_1H":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_1D":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_2D":{"type":"number","minimum":1e-9,"maximum":1000000},"version":{"type":"string","enum":["2008","2025"]},"source":{"type":"string","enum":["FEH_WEB_SERVICE","FEH_CD3","NRFA","MANUAL","HYDRO_FAUCET","DERIVED"]},"fetchedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["AREA","DPLBAR","DPSBAR","LDP","SAAR","BFIHOST","PROPWET","SPRHOST","URBEXT2000","FARL","FPEXT","version","source","fetchedAt"],"additionalProperties":false},"family":{"type":"string","enum":["FEH_SM2008","FEH_SM2025"]},"qmed":{"type":"number","minimum":0,"maximum":1000000},"qmedSource":{"type":"string","enum":["amax","fdc-stats","descriptors-rural","descriptors-urban","donor-adjusted","user-override"]},"donorIds":{"default":[],"maxItems":50,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000}},"growthSource":{"type":"string","enum":["single-site","enhanced-single-site","enhanced-single-site-ukfe","pooled","pooled-ukfe"]},"effectiveRecordLength":{"type":"integer","minimum":4,"maximum":500}},"required":["distribution","lCV","lSkew","descriptors","family","qmed","qmedSource","growthSource","effectiveRecordLength"],"additionalProperties":false},"CalculationStageInput_ddf_import_csv":{"type":"object","properties":{"csv":{"type":"string","minLength":1,"maxLength":200000},"basis":{"type":"string","enum":["point","catchment-average"]}},"required":["csv","basis"],"additionalProperties":false},"CalculationStageInput_ddf_import_xml":{"type":"object","properties":{"xml":{"type":"string","minLength":1,"maxLength":200000},"fallbackBasis":{"type":"string","enum":["point","catchment-average"]}},"required":["xml","fallbackBasis"],"additionalProperties":false},"CalculationStageInput_ddf_import_stored_feh22":{"type":"object","properties":{"datasetVersion":{"type":"string","enum":["14.0.1","15.0.2"]},"stationId":{"type":"integer","exclusiveMinimum":0,"maximum":1000000000},"value":{"type":"object","properties":{"returnPeriods":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"number","minimum":1e-9,"maximum":100000}},"depths":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"object","properties":{"duration":{"type":"number","minimum":1e-9,"maximum":10000},"values":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"number","minimum":0,"maximum":100000}}},"required":["duration","values"],"additionalProperties":false}}},"required":["returnPeriods","depths"],"additionalProperties":false}},"required":["datasetVersion","stationId","value"],"additionalProperties":false},"CalculationStageInput_ddf_lookup":{"type":"object","properties":{"table":{"type":"object","properties":{"source":{"type":"string","enum":["FEH_IMPORT","MANUAL"]},"basis":{"type":"string","enum":["point","catchment-average"]},"modelVersion":{"type":"string","minLength":1,"maxLength":80},"arfState":{"type":"string","enum":["applied","not-applied"]},"arf":{"type":"number","exclusiveMinimum":0,"maximum":1},"arfDurationHours":{"type":"number","minimum":1e-9,"maximum":10000},"areaKm2":{"type":"number","minimum":1e-9,"maximum":100000},"scale":{"type":"string","enum":["annual-maximum","peaks-over-threshold"]},"durationBasis":{"type":"string","enum":["sliding","fixed"]},"durations":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"number","minimum":1e-9,"maximum":10000}},"returnPeriods":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"number","minimum":1e-9,"maximum":100000}},"depths":{"minItems":1,"maxItems":100,"type":"array","items":{"minItems":1,"maxItems":100,"type":"array","items":{"type":"number","minimum":0,"maximum":10000}}}},"required":["source","basis","durations","returnPeriods","depths"],"additionalProperties":false},"durationHours":{"type":"number","minimum":0.016666666666666666,"maximum":240},"returnPeriods":{"default":[2,5,10,20,30,50,75,100,200,1000],"minItems":1,"maxItems":20,"type":"array","items":{"type":"number","minimum":2,"maximum":1000}}},"required":["table","durationHours"],"additionalProperties":false},"CalculationStageInput_ddf_rmed":{"type":"object","properties":{"rmed":{"type":"object","properties":{"rmed1h":{"type":"number","minimum":1e-9,"maximum":1000000},"rmed1d":{"type":"number","minimum":1e-9,"maximum":1000000},"rmed2d":{"type":"number","minimum":1e-9,"maximum":1000000}},"required":["rmed1h","rmed1d","rmed2d"],"additionalProperties":false},"durationHours":{"type":"number","minimum":0.016666666666666666,"maximum":240}},"required":["rmed","durationHours"],"additionalProperties":false},"CalculationStageInput_rainfall_arf":{"type":"object","properties":{"areaKm2":{"type":"number","minimum":1e-9,"maximum":100000},"durationHours":{"type":"number","minimum":0.016666666666666666,"maximum":240}},"required":["areaKm2","durationHours"],"additionalProperties":false},"CalculationStageInput_rainfall_profile":{"type":"object","properties":{"season":{"type":"string","enum":["winter","summer"]},"durationHours":{"type":"number","minimum":0.016666666666666666,"maximum":240},"timestepMinutes":{"type":"number","minimum":1,"maximum":60},"totalDepthMm":{"type":"number","minimum":0,"maximum":10000}},"required":["season","durationHours","timestepMinutes","totalDepthMm"],"additionalProperties":false},"CalculationStageInput_rainfall_runoff_pdm_loss":{"type":"object","properties":{"grossRainfall":{"minItems":1,"maxItems":2048,"type":"array","items":{"type":"number","minimum":0,"maximum":1000000}},"Cmax":{"type":"number","minimum":1e-9,"maximum":10000},"Cini":{"type":"number","minimum":0,"maximum":10000}},"required":["grossRainfall","Cmax","Cini"],"additionalProperties":false},"CalculationStageInput_routing_unit_hydrograph":{"type":"object","properties":{"Tp":{"type":"number","minimum":0.01,"maximum":240},"Up":{"type":"number","minimum":0.1,"maximum":1},"Uk":{"type":"number","minimum":0.1,"maximum":1},"timestepMinutes":{"type":"number","minimum":1,"maximum":60}},"required":["Tp","Up","Uk","timestepMinutes"],"additionalProperties":false},"CalculationStageInput_routing_convolve":{"type":"object","properties":{"netRainfall":{"minItems":1,"maxItems":2048,"type":"array","items":{"type":"number","minimum":0,"maximum":1000000}},"iuh":{"minItems":1,"maxItems":2048,"type":"array","items":{"type":"number","minimum":0,"maximum":1000000}},"areaKm2":{"type":"number","minimum":1e-9,"maximum":100000},"timestepMinutes":{"type":"number","minimum":1,"maximum":60}},"required":["netRainfall","iuh","areaKm2","timestepMinutes"],"additionalProperties":false},"CalculationStageInput_routing_baseflow":{"type":"object","properties":{"BL":{"type":"number","minimum":0.01,"maximum":10000},"BR":{"type":"number","minimum":0,"maximum":10},"BF0":{"type":"number","minimum":0,"maximum":1000000},"directRunoff":{"minItems":1,"maxItems":2048,"type":"array","items":{"type":"number","minimum":0,"maximum":1000000}},"timestepMinutes":{"type":"number","minimum":1,"maximum":60}},"required":["BL","BR","BF0","directRunoff","timestepMinutes"],"additionalProperties":false},"CalculationStageInput_rainfall_runoff_rational":{"type":"object","properties":{"coefficient":{"type":"number","minimum":0,"maximum":1},"rainfallIntensityMmPerHour":{"type":"number","minimum":0,"maximum":10000},"areaKm2":{"type":"number","minimum":1e-9,"maximum":100000}},"required":["coefficient","rainfallIntensityMmPerHour","areaKm2"],"additionalProperties":false},"CalculationStageInput_rainfall_runoff_rational_coefficient":{"oneOf":[{"type":"object","properties":{"method":{"type":"string","const":"sprhost"},"SPRHOST":{"type":"number","minimum":0,"maximum":100},"urbext":{"default":0,"type":"number","minimum":0,"maximum":1},"imperviousnessEfficiency":{"default":0.8,"type":"number","minimum":0,"maximum":1},"storageFactor":{"default":1,"type":"number","minimum":0,"maximum":1},"returnPeriods":{"default":[2,5,10,20,30,50,75,100,200],"minItems":1,"maxItems":20,"type":"array","items":{"type":"number","minimum":2,"maximum":200}}},"required":["method","SPRHOST"],"additionalProperties":false},{"type":"object","properties":{"method":{"type":"string","const":"land-use"},"landUse":{"type":"string","enum":["commercial_city_centre","commercial_neighbourhood","residential_high_density","residential_medium_density","residential_low_density","industrial_heavy","industrial_light","parks_and_gardens","woodland","arable_farmland","grassland_pasture","moorland_upland","bare_rock_or_paved"]},"variant":{"default":"typical","type":"string","enum":["min","typical","max"]},"urbext":{"default":0,"type":"number","minimum":0,"maximum":1},"imperviousnessEfficiency":{"default":0.8,"type":"number","minimum":0,"maximum":1},"storageFactor":{"default":1,"type":"number","minimum":0,"maximum":1},"returnPeriods":{"default":[2,5,10,20,30,50,75,100,200],"minItems":1,"maxItems":20,"type":"array","items":{"type":"number","minimum":2,"maximum":200}}},"required":["method","landUse"],"additionalProperties":false}]},"CalculationStageInput_rainfall_runoff_rational_design":{"type":"object","properties":{"descriptors":{"type":"object","properties":{"AREA":{"type":"number","minimum":1e-9,"maximum":100000},"DPLBAR":{"type":"number","minimum":1e-9,"maximum":5000},"DPSBAR":{"type":"number","minimum":1e-9,"maximum":10000},"LDP":{"type":"number","minimum":1e-9,"maximum":5000},"SAAR":{"type":"number","minimum":1e-9,"maximum":10000},"SAAR9120":{"type":"number","minimum":1e-9,"maximum":10000},"BFIHOST":{"type":"number","minimum":0,"maximum":1},"BFIHOST19":{"type":"number","minimum":0,"maximum":1},"BFIHOST19scaled":{"type":"number","minimum":0,"maximum":1},"PROPWET":{"type":"number","minimum":0,"maximum":1},"SPRHOST":{"type":"number","minimum":0,"maximum":100},"URBEXT2000":{"type":"number","minimum":0,"maximum":1},"URBEXT2015":{"type":"number","minimum":0,"maximum":1},"FARL":{"type":"number","exclusiveMinimum":0,"maximum":1},"FARL2015":{"type":"number","exclusiveMinimum":0,"maximum":1},"FPEXT":{"type":"number","minimum":0,"maximum":1},"ALTBAR":{"type":"number","minimum":0,"maximum":10000},"RMED_1H":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_1D":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_2D":{"type":"number","minimum":1e-9,"maximum":1000000},"version":{"type":"string","enum":["2008","2025"]},"source":{"type":"string","enum":["FEH_WEB_SERVICE","FEH_CD3","NRFA","MANUAL","HYDRO_FAUCET","DERIVED"]},"fetchedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["AREA","DPLBAR","DPSBAR","LDP","SAAR","BFIHOST","PROPWET","SPRHOST","URBEXT2000","FARL","FPEXT","version","source","fetchedAt"],"additionalProperties":false},"events":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"returnPeriod":{"type":"number","minimum":2,"maximum":200},"intensityMmPerHour":{"type":"number","minimum":1e-9,"maximum":10000}},"required":["returnPeriod","intensityMmPerHour"],"additionalProperties":false}},"urbext":{"type":"number","minimum":0,"maximum":1},"runoffCoefficient":{"type":"number","minimum":0,"maximum":1},"timeOfConcentration":{"type":"number","minimum":1e-9,"maximum":240},"storageFactor":{"default":1,"type":"number","minimum":0,"maximum":1},"fehQMED":{"type":"number","minimum":1e-9,"maximum":1000000}},"required":["descriptors","events","urbext"],"additionalProperties":false},"CalculationStageInput_rainfall_runoff_time_of_concentration":{"type":"object","properties":{"LDP":{"type":"number","minimum":1e-9,"maximum":5000},"AREA":{"type":"number","minimum":1e-9,"maximum":100000},"DPSBAR":{"type":"number","minimum":1e-9,"maximum":10000},"DPLBAR":{"type":"number","minimum":1e-9,"maximum":5000}},"required":["LDP","AREA","DPSBAR","DPLBAR"],"additionalProperties":false},"CalculationStageInput_rainfall_runoff_curve_number":{"type":"object","properties":{"SPRHOST":{"type":"number","minimum":0,"maximum":100},"BFIHOST":{"type":"number","minimum":0,"maximum":1},"URBEXT2000":{"type":"number","minimum":0,"maximum":1}},"required":["SPRHOST","BFIHOST","URBEXT2000"],"additionalProperties":false},"CalculationStageInput_rainfall_runoff_scs_loss":{"type":"object","properties":{"rainfallDepthMm":{"type":"number","minimum":0,"maximum":10000},"curveNumber":{"type":"number","minimum":1,"maximum":100},"iaMethod":{"default":"traditional","type":"string","enum":["traditional","updated"]}},"required":["rainfallDepthMm","curveNumber"],"additionalProperties":false},"CalculationStageInput_routing_scs_unit_hydrograph":{"type":"object","properties":{"areaKm2":{"type":"number","minimum":1e-9,"maximum":100000},"flowPathKm":{"type":"number","minimum":1e-9,"maximum":5000},"slopePercent":{"type":"number","minimum":1e-9,"maximum":1000},"retentionMm":{"type":"number","minimum":0,"maximum":10000},"stormDurationHours":{"type":"number","minimum":0.016666666666666666,"maximum":240}},"required":["areaKm2","flowPathKm","slopePercent","retentionMm","stormDurationHours"],"additionalProperties":false},"CalculationStageInput_rainfall_runoff_scs_event":{"type":"object","properties":{"descriptors":{"type":"object","properties":{"AREA":{"type":"number","minimum":1e-9,"maximum":100000},"DPLBAR":{"type":"number","minimum":1e-9,"maximum":5000},"DPSBAR":{"type":"number","minimum":1e-9,"maximum":10000},"LDP":{"type":"number","minimum":1e-9,"maximum":5000},"SAAR":{"type":"number","minimum":1e-9,"maximum":10000},"SAAR9120":{"type":"number","minimum":1e-9,"maximum":10000},"BFIHOST":{"type":"number","minimum":0,"maximum":1},"BFIHOST19":{"type":"number","minimum":0,"maximum":1},"BFIHOST19scaled":{"type":"number","minimum":0,"maximum":1},"PROPWET":{"type":"number","minimum":0,"maximum":1},"SPRHOST":{"type":"number","minimum":0,"maximum":100},"URBEXT2000":{"type":"number","minimum":0,"maximum":1},"URBEXT2015":{"type":"number","minimum":0,"maximum":1},"FARL":{"type":"number","exclusiveMinimum":0,"maximum":1},"FARL2015":{"type":"number","exclusiveMinimum":0,"maximum":1},"FPEXT":{"type":"number","minimum":0,"maximum":1},"ALTBAR":{"type":"number","minimum":0,"maximum":10000},"RMED_1H":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_1D":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_2D":{"type":"number","minimum":1e-9,"maximum":1000000},"version":{"type":"string","enum":["2008","2025"]},"source":{"type":"string","enum":["FEH_WEB_SERVICE","FEH_CD3","NRFA","MANUAL","HYDRO_FAUCET","DERIVED"]},"fetchedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["AREA","DPLBAR","DPSBAR","LDP","SAAR","BFIHOST","PROPWET","SPRHOST","URBEXT2000","FARL","FPEXT","version","source","fetchedAt"],"additionalProperties":false},"event":{"type":"object","properties":{"rainfallDepthMm":{"type":"number","minimum":0,"maximum":10000},"stormDurationHours":{"type":"number","minimum":0.016666666666666666,"maximum":240},"returnPeriod":{"type":"number","minimum":2,"maximum":1000},"amc":{"default":"II","type":"string","enum":["I","II","III"]},"iaMethod":{"default":"traditional","type":"string","enum":["traditional","updated"]}},"required":["rainfallDepthMm","stormDurationHours","returnPeriod"],"additionalProperties":false}},"required":["descriptors","event"],"additionalProperties":false},"CalculationStageInput_climate_allowance":{"oneOf":[{"type":"object","properties":{"jurisdiction":{"type":"string","const":"England"},"managementCatchment":{"type":"string","minLength":1,"maxLength":100},"epoch":{"type":"string","enum":["2020s","2050s","2080s"]},"scenario":{"type":"string","enum":["central","higherCentral","upperEnd","hPlusPlus"]}},"required":["jurisdiction","managementCatchment","epoch","scenario"],"additionalProperties":false},{"type":"object","properties":{"jurisdiction":{"type":"string","enum":["Wales","Scotland"]},"nationalClimateRegion":{"type":"string","enum":["wales-dee","wales-west-wales","wales-severn","scotland-argyll","scotland-clyde","scotland-forth","scotland-north-east","scotland-north-highland","scotland-orkney","scotland-shetland","scotland-solway","scotland-tay","scotland-tweed","scotland-western-isles","scotland-west-highland"]},"epoch":{"type":"string","enum":["2100","2020s","2050s","2080s"]},"scenario":{"type":"string","enum":["central","upperEnd","total"]},"catchmentAreaKm2":{"type":"number","minimum":1e-9,"maximum":100000}},"required":["jurisdiction","nationalClimateRegion","epoch","scenario"],"additionalProperties":false}]},"CalculationStageInput_climate_apply":{"type":"object","properties":{"baseStageDigest":{"type":"string","pattern":"^[a-f0-9]{64}$"},"alreadyClimateAdjusted":{"type":"boolean","const":false},"allowancePercent":{"type":"number","minimum":-100,"maximum":300},"allowanceSource":{"type":"string","minLength":1,"maxLength":200},"flows":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"returnPeriod":{"type":"number","minimum":2,"maximum":1000},"flowM3s":{"type":"number","minimum":0,"maximum":1000000}},"required":["returnPeriod","flowM3s"],"additionalProperties":false}}},"required":["baseStageDigest","alreadyClimateAdjusted","allowancePercent","allowanceSource","flows"],"additionalProperties":false},"CalculationStageInput_hydrograph_import_csv":{"type":"object","properties":{"csv":{"type":"string","minLength":1,"maxLength":100000},"filename":{"type":"string","minLength":1,"maxLength":200,"pattern":"^[^\\\\/\\x00-\\x1f]+$"}},"required":["csv","filename"],"additionalProperties":false},"CalculationStageInput_observations_flow_statistics":{"type":"object","properties":{"records":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"flow":{"type":"number","minimum":0,"maximum":1000000}},"required":["date","flow"],"additionalProperties":false}},"curvePoints":{"default":200,"type":"integer","minimum":2,"maximum":200}},"required":["records"],"additionalProperties":false},"CalculationStageInput_observations_events":{"type":"object","properties":{"records":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"flow":{"type":"number","minimum":0,"maximum":1000000}},"required":["date","flow"],"additionalProperties":false}},"amax":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"waterYear":{"type":"integer","minimum":1500,"maximum":2200},"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"flow":{"type":"number","minimum":0,"maximum":1000000},"rejected":{"type":"boolean"}},"required":["waterYear","date","flow","rejected"],"additionalProperties":false}},"daysBefore":{"default":7,"type":"integer","minimum":1,"maximum":30},"daysAfter":{"default":14,"type":"integer","minimum":1,"maximum":30}},"required":["records","amax"],"additionalProperties":false},"CalculationStageInput_observations_baseflow":{"type":"object","properties":{"records":{"minItems":1,"maxItems":5000,"type":"array","items":{"type":"object","properties":{"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"flow":{"type":"number","minimum":0,"maximum":1000000}},"required":["date","flow"],"additionalProperties":false}},"alpha":{"default":0.925,"type":"number","minimum":0,"exclusiveMaximum":1},"passes":{"default":3,"type":"number","const":3},"nReflect":{"default":30,"type":"integer","minimum":0,"maximum":100},"minRecessionDays":{"default":5,"type":"integer","minimum":2,"maximum":100}},"required":["records"],"additionalProperties":false},"CalculationStageInput_amax_seasonality":{"type":"object","properties":{"records":{"maxItems":500,"type":"array","items":{"type":"object","properties":{"waterYear":{"type":"integer","minimum":1500,"maximum":2200},"date":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"flow":{"type":"number","minimum":0,"maximum":1000000},"rejected":{"type":"boolean"}},"required":["waterYear","date","flow","rejected"],"additionalProperties":false}}},"required":["records"],"additionalProperties":false},"CalculationStageInput_hydrograph_scale":{"type":"object","properties":{"points":{"minItems":2,"maxItems":2048,"type":"array","items":{"type":"object","properties":{"t":{"type":"number","minimum":0,"maximum":10000},"q":{"type":"number","minimum":0,"maximum":1}},"required":["t","q"],"additionalProperties":false}},"flows":{"minItems":1,"maxItems":20,"type":"array","items":{"type":"object","properties":{"returnPeriod":{"type":"number","minimum":2,"maximum":1000},"peakFlow":{"type":"number","minimum":0,"maximum":1000000},"baseflow":{"type":"number","minimum":0,"maximum":1000000}},"required":["returnPeriod","peakFlow"],"additionalProperties":false}}},"required":["points","flows"],"additionalProperties":false},"CalculationStageInput_climate_spatial_selection":{"type":"object","properties":{"crs":{"type":"string","const":"EPSG:27700"},"boundary":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"Polygon"},"coordinates":{"minItems":1,"maxItems":4,"type":"array","items":{"minItems":4,"maxItems":100,"type":"array","items":{"type":"array","prefixItems":[{"type":"number","minimum":0,"maximum":700000},{"type":"number","minimum":0,"maximum":1300000}],"items":false,"minItems":2,"maxItems":2}}}},"required":["type","coordinates"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"MultiPolygon"},"coordinates":{"minItems":1,"maxItems":4,"type":"array","items":{"minItems":1,"maxItems":4,"type":"array","items":{"minItems":4,"maxItems":100,"type":"array","items":{"type":"array","prefixItems":[{"type":"number","minimum":0,"maximum":700000},{"type":"number","minimum":0,"maximum":1300000}],"items":false,"minItems":2,"maxItems":2}}}}},"required":["type","coordinates"],"additionalProperties":false}]},"epoch":{"type":"string","enum":["2020s","2050s","2080s"]},"scenario":{"type":"string","enum":["central","higherCentral","upperEnd","hPlusPlus"]}},"required":["crs","boundary","epoch","scenario"],"additionalProperties":false},"CalculationStageInput_catchment_residual":{"type":"object","properties":{"crs":{"type":"string","const":"EPSG:4326"},"control":{"type":"object","properties":{"descriptors":{"type":"object","properties":{"AREA":{"type":"number","minimum":1e-9,"maximum":100000},"DPLBAR":{"type":"number","minimum":1e-9,"maximum":5000},"DPSBAR":{"type":"number","minimum":1e-9,"maximum":10000},"LDP":{"type":"number","minimum":1e-9,"maximum":5000},"SAAR":{"type":"number","minimum":1e-9,"maximum":10000},"SAAR9120":{"type":"number","minimum":1e-9,"maximum":10000},"BFIHOST":{"type":"number","minimum":0,"maximum":1},"BFIHOST19":{"type":"number","minimum":0,"maximum":1},"BFIHOST19scaled":{"type":"number","minimum":0,"maximum":1},"PROPWET":{"type":"number","minimum":0,"maximum":1},"SPRHOST":{"type":"number","minimum":0,"maximum":100},"URBEXT2000":{"type":"number","minimum":0,"maximum":1},"URBEXT2015":{"type":"number","minimum":0,"maximum":1},"FARL":{"type":"number","exclusiveMinimum":0,"maximum":1},"FARL2015":{"type":"number","exclusiveMinimum":0,"maximum":1},"FPEXT":{"type":"number","minimum":0,"maximum":1},"ALTBAR":{"type":"number","minimum":0,"maximum":10000},"RMED_1H":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_1D":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_2D":{"type":"number","minimum":1e-9,"maximum":1000000},"version":{"type":"string","enum":["2008","2025"]},"source":{"type":"string","enum":["FEH_WEB_SERVICE","FEH_CD3","NRFA","MANUAL","HYDRO_FAUCET","DERIVED"]},"fetchedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["AREA","DPLBAR","DPSBAR","LDP","SAAR","BFIHOST","PROPWET","SPRHOST","URBEXT2000","FARL","FPEXT","version","source","fetchedAt"],"additionalProperties":false},"geometry":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"Polygon"},"coordinates":{"minItems":1,"maxItems":4,"type":"array","items":{"minItems":4,"maxItems":100,"type":"array","items":{"type":"array","prefixItems":[{"type":"number","minimum":-9,"maximum":3},{"type":"number","minimum":49,"maximum":61}],"items":false,"minItems":2,"maxItems":2}}}},"required":["type","coordinates"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"MultiPolygon"},"coordinates":{"minItems":1,"maxItems":4,"type":"array","items":{"minItems":1,"maxItems":4,"type":"array","items":{"minItems":4,"maxItems":100,"type":"array","items":{"type":"array","prefixItems":[{"type":"number","minimum":-9,"maximum":3},{"type":"number","minimum":49,"maximum":61}],"items":false,"minItems":2,"maxItems":2}}}}},"required":["type","coordinates"],"additionalProperties":false}]}},"required":["descriptors","geometry"],"additionalProperties":false},"subs":{"minItems":1,"maxItems":8,"type":"array","items":{"type":"object","properties":{"descriptors":{"type":"object","properties":{"AREA":{"type":"number","minimum":1e-9,"maximum":100000},"DPLBAR":{"type":"number","minimum":1e-9,"maximum":5000},"DPSBAR":{"type":"number","minimum":1e-9,"maximum":10000},"LDP":{"type":"number","minimum":1e-9,"maximum":5000},"SAAR":{"type":"number","minimum":1e-9,"maximum":10000},"SAAR9120":{"type":"number","minimum":1e-9,"maximum":10000},"BFIHOST":{"type":"number","minimum":0,"maximum":1},"BFIHOST19":{"type":"number","minimum":0,"maximum":1},"BFIHOST19scaled":{"type":"number","minimum":0,"maximum":1},"PROPWET":{"type":"number","minimum":0,"maximum":1},"SPRHOST":{"type":"number","minimum":0,"maximum":100},"URBEXT2000":{"type":"number","minimum":0,"maximum":1},"URBEXT2015":{"type":"number","minimum":0,"maximum":1},"FARL":{"type":"number","exclusiveMinimum":0,"maximum":1},"FARL2015":{"type":"number","exclusiveMinimum":0,"maximum":1},"FPEXT":{"type":"number","minimum":0,"maximum":1},"ALTBAR":{"type":"number","minimum":0,"maximum":10000},"RMED_1H":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_1D":{"type":"number","minimum":1e-9,"maximum":1000000},"RMED_2D":{"type":"number","minimum":1e-9,"maximum":1000000},"version":{"type":"string","enum":["2008","2025"]},"source":{"type":"string","enum":["FEH_WEB_SERVICE","FEH_CD3","NRFA","MANUAL","HYDRO_FAUCET","DERIVED"]},"fetchedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$"}},"required":["AREA","DPLBAR","DPSBAR","LDP","SAAR","BFIHOST","PROPWET","SPRHOST","URBEXT2000","FARL","FPEXT","version","source","fetchedAt"],"additionalProperties":false},"geometry":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"Polygon"},"coordinates":{"minItems":1,"maxItems":4,"type":"array","items":{"minItems":4,"maxItems":100,"type":"array","items":{"type":"array","prefixItems":[{"type":"number","minimum":-9,"maximum":3},{"type":"number","minimum":49,"maximum":61}],"items":false,"minItems":2,"maxItems":2}}}},"required":["type","coordinates"],"additionalProperties":false},{"type":"object","properties":{"type":{"type":"string","const":"MultiPolygon"},"coordinates":{"minItems":1,"maxItems":4,"type":"array","items":{"minItems":1,"maxItems":4,"type":"array","items":{"minItems":4,"maxItems":100,"type":"array","items":{"type":"array","prefixItems":[{"type":"number","minimum":-9,"maximum":3},{"type":"number","minimum":49,"maximum":61}],"items":false,"minItems":2,"maxItems":2}}}}},"required":["type","coordinates"],"additionalProperties":false}]}},"required":["descriptors","geometry"],"additionalProperties":false}}},"required":["crs","control","subs"],"additionalProperties":false},"CalculationStageRequest":{"description":"Choose one available stage. The catalog records unsupported, licensed and experimental capabilities explicitly; these cannot be executed.","allOf":[{"$ref":"#/components/schemas/CalculationStageEnvelope"}],"oneOf":[{"properties":{"stage":{"const":"descriptors.scale_dplbar"},"input":{"$ref":"#/components/schemas/CalculationStageInput_descriptors_scale_dplbar"}}},{"properties":{"stage":{"const":"descriptors.import"},"input":{"$ref":"#/components/schemas/CalculationStageInput_descriptors_import"}}},{"properties":{"stage":{"const":"amax.screen"},"input":{"$ref":"#/components/schemas/CalculationStageInput_amax_screen"}}},{"properties":{"stage":{"const":"descriptors.validate"},"input":{"$ref":"#/components/schemas/CalculationStageInput_descriptors_validate"}}},{"properties":{"stage":{"const":"amax.diagnostics"},"input":{"$ref":"#/components/schemas/CalculationStageInput_amax_diagnostics"}}},{"properties":{"stage":{"const":"qmed.amax"},"input":{"$ref":"#/components/schemas/CalculationStageInput_qmed_amax"}}},{"properties":{"stage":{"const":"qmed.descriptors"},"input":{"$ref":"#/components/schemas/CalculationStageInput_qmed_descriptors"}}},{"properties":{"stage":{"const":"qmed.fdc"},"input":{"$ref":"#/components/schemas/CalculationStageInput_qmed_fdc"}}},{"properties":{"stage":{"const":"qmed.urban"},"input":{"$ref":"#/components/schemas/CalculationStageInput_qmed_urban"}}},{"properties":{"stage":{"const":"donors.similarity"},"input":{"$ref":"#/components/schemas/CalculationStageInput_donors_similarity"}}},{"properties":{"stage":{"const":"donors.adjust"},"input":{"$ref":"#/components/schemas/CalculationStageInput_donors_adjust"}}},{"properties":{"stage":{"const":"donors.screen"},"input":{"$ref":"#/components/schemas/CalculationStageInput_donors_screen"}}},{"properties":{"stage":{"const":"pooling.select"},"input":{"$ref":"#/components/schemas/CalculationStageInput_pooling_select"}}},{"properties":{"stage":{"const":"pooling.moments"},"input":{"$ref":"#/components/schemas/CalculationStageInput_pooling_moments"}}},{"properties":{"stage":{"const":"moments.sample"},"input":{"$ref":"#/components/schemas/CalculationStageInput_moments_sample"}}},{"properties":{"stage":{"const":"distribution.fit"},"input":{"$ref":"#/components/schemas/CalculationStageInput_distribution_fit"}}},{"properties":{"stage":{"const":"growth.evaluate"},"input":{"$ref":"#/components/schemas/CalculationStageInput_growth_evaluate"}}},{"properties":{"stage":{"const":"nfy.detect"},"input":{"$ref":"#/components/schemas/CalculationStageInput_nfy_detect"}}},{"properties":{"stage":{"const":"nfy.adjust_glo"},"input":{"$ref":"#/components/schemas/CalculationStageInput_nfy_adjust_glo"}}},{"properties":{"stage":{"const":"uncertainty.delta"},"input":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_delta"}}},{"properties":{"stage":{"const":"uncertainty.bootstrap"},"input":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_bootstrap"}}},{"properties":{"stage":{"const":"uncertainty.gauged"},"input":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_gauged"}}},{"properties":{"stage":{"const":"uncertainty.ungauged"},"input":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_ungauged"}}},{"properties":{"stage":{"const":"uncertainty.qmed_fse"},"input":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_qmed_fse"}}},{"properties":{"stage":{"const":"uncertainty.qmed_descriptor"},"input":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_qmed_descriptor"}}},{"properties":{"stage":{"const":"uncertainty.effective_record_length"},"input":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_effective_record_length"}}},{"properties":{"stage":{"const":"uncertainty.pooled_resampling"},"input":{"$ref":"#/components/schemas/CalculationStageInput_uncertainty_pooled_resampling"}}},{"properties":{"stage":{"const":"nfy.pooled"},"input":{"$ref":"#/components/schemas/CalculationStageInput_nfy_pooled"}}},{"properties":{"stage":{"const":"pooling.diagnostics"},"input":{"$ref":"#/components/schemas/CalculationStageInput_pooling_diagnostics"}}},{"properties":{"stage":{"const":"design.flows"},"input":{"$ref":"#/components/schemas/CalculationStageInput_design_flows"}}},{"properties":{"stage":{"const":"ddf.import_csv"},"input":{"$ref":"#/components/schemas/CalculationStageInput_ddf_import_csv"}}},{"properties":{"stage":{"const":"ddf.import_xml"},"input":{"$ref":"#/components/schemas/CalculationStageInput_ddf_import_xml"}}},{"properties":{"stage":{"const":"ddf.import_stored_feh22"},"input":{"$ref":"#/components/schemas/CalculationStageInput_ddf_import_stored_feh22"}}},{"properties":{"stage":{"const":"ddf.lookup"},"input":{"$ref":"#/components/schemas/CalculationStageInput_ddf_lookup"}}},{"properties":{"stage":{"const":"ddf.rmed"},"input":{"$ref":"#/components/schemas/CalculationStageInput_ddf_rmed"}}},{"properties":{"stage":{"const":"rainfall.arf"},"input":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_arf"}}},{"properties":{"stage":{"const":"rainfall.profile"},"input":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_profile"}}},{"properties":{"stage":{"const":"rainfall_runoff.pdm_loss"},"input":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_pdm_loss"}}},{"properties":{"stage":{"const":"routing.unit_hydrograph"},"input":{"$ref":"#/components/schemas/CalculationStageInput_routing_unit_hydrograph"}}},{"properties":{"stage":{"const":"routing.convolve"},"input":{"$ref":"#/components/schemas/CalculationStageInput_routing_convolve"}}},{"properties":{"stage":{"const":"routing.baseflow"},"input":{"$ref":"#/components/schemas/CalculationStageInput_routing_baseflow"}}},{"properties":{"stage":{"const":"rainfall_runoff.rational"},"input":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_rational"}}},{"properties":{"stage":{"const":"rainfall_runoff.rational_coefficient"},"input":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_rational_coefficient"}}},{"properties":{"stage":{"const":"rainfall_runoff.rational_design"},"input":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_rational_design"}}},{"properties":{"stage":{"const":"rainfall_runoff.time_of_concentration"},"input":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_time_of_concentration"}}},{"properties":{"stage":{"const":"rainfall_runoff.curve_number"},"input":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_curve_number"}}},{"properties":{"stage":{"const":"rainfall_runoff.scs_loss"},"input":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_scs_loss"}}},{"properties":{"stage":{"const":"routing.scs_unit_hydrograph"},"input":{"$ref":"#/components/schemas/CalculationStageInput_routing_scs_unit_hydrograph"}}},{"properties":{"stage":{"const":"rainfall_runoff.scs_event"},"input":{"$ref":"#/components/schemas/CalculationStageInput_rainfall_runoff_scs_event"}}},{"properties":{"stage":{"const":"climate.allowance"},"input":{"$ref":"#/components/schemas/CalculationStageInput_climate_allowance"}}},{"properties":{"stage":{"const":"climate.apply"},"input":{"$ref":"#/components/schemas/CalculationStageInput_climate_apply"}}},{"properties":{"stage":{"const":"hydrograph.import_csv"},"input":{"$ref":"#/components/schemas/CalculationStageInput_hydrograph_import_csv"}}},{"properties":{"stage":{"const":"observations.flow_statistics"},"input":{"$ref":"#/components/schemas/CalculationStageInput_observations_flow_statistics"}}},{"properties":{"stage":{"const":"observations.events"},"input":{"$ref":"#/components/schemas/CalculationStageInput_observations_events"}}},{"properties":{"stage":{"const":"observations.baseflow"},"input":{"$ref":"#/components/schemas/CalculationStageInput_observations_baseflow"}}},{"properties":{"stage":{"const":"amax.seasonality"},"input":{"$ref":"#/components/schemas/CalculationStageInput_amax_seasonality"}}},{"properties":{"stage":{"const":"hydrograph.scale"},"input":{"$ref":"#/components/schemas/CalculationStageInput_hydrograph_scale"}}},{"properties":{"stage":{"const":"climate.spatial_selection"},"input":{"$ref":"#/components/schemas/CalculationStageInput_climate_spatial_selection"}}},{"properties":{"stage":{"const":"catchment.residual"},"input":{"$ref":"#/components/schemas/CalculationStageInput_catchment_residual"}}}]}}},"paths":{"/api/v1/assessments/gauged":{"post":{"operationId":"runGaugedAssessment","summary":"Run or recover a durable gauged assessment","description":"Same shared operation as MCP run_gauged_assessment. Supply idempotencyKey for safe retries across REST and MCP. The exact completed execution is retained for 24 hours and can be read at GET /api/v1/runs/{runId}. Retry identity is separate from scientific computation, billing and permanent saved IDs. A completed retry returns its original evidence even if the current data source changed or is unavailable. Changed inputs with the same key are refused. Missing/failed runs are never silently restarted. Options expose bounded analyst choices and up to twenty periods; no implicit Method Space run. Ungauged descriptors are MANUAL inputs; /api/v1/estimate keeps its existing unmetered service policy.","x-credit-policy":"One assessment credit for new uncached work unless unlimited; cache hits and completed retries are free. Original billing receipt is preserved. Atomic result publication and reservation settlement precede delivery.","x-permissions":"Active minted account key or legacy service key with verified on-behalf identity. Captured account generation is checked again at run admission/publication. REST does not accept OAuth.","x-max-request-bytes":524288,"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GaugedAssessmentRequest"},"examples":{"example":{"summary":"Illustrative inputs; replace with authoritative data.","value":{"stationId":39001,"options":{"returnPeriods":[2,30,100,1000]},"idempotencyKey":"assessment-example-1"}}}}}},"responses":{"200":{"description":"Shared assessment summary, durable execution identity and original billing receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GaugedAssessmentResponse"}}}},"400":{"description":"Malformed JSON, unknown fields, invalid options or scientific inputs. Validates before billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"402":{"description":"Assessment credit is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["quota_exhausted"]},"404":{"description":"Account generation or retained execution is no longer available.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["not_available"]},"409":{"description":"Retry input conflict, execution already running/failed, or retention capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["idempotency_conflict","run_in_progress","run_failed","run_limit_reached"]},"413":{"description":"Request exceeds the body limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["input_too_large"]},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Calculation or durable publication could not complete. Retry the same key to recover an already completed result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["analysis_failed"]},"503":{"description":"Required source is unavailable; no fabricated result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["DATA_SOURCE_UNAVAILABLE"]}}}},"/api/v1/assessments/ungauged":{"post":{"operationId":"runUngaugedAssessment","summary":"Run or recover a durable ungauged assessment","description":"Same shared operation as MCP run_ungauged_assessment. Supply idempotencyKey for safe retries across REST and MCP. The exact completed execution is retained for 24 hours and can be read at GET /api/v1/runs/{runId}. Retry identity is separate from scientific computation, billing and permanent saved IDs. A completed retry returns its original evidence even if the current data source changed or is unavailable. Changed inputs with the same key are refused. Missing/failed runs are never silently restarted. Options expose bounded analyst choices and up to twenty periods; no implicit Method Space run. Ungauged descriptors are MANUAL inputs; /api/v1/estimate keeps its existing unmetered service policy.","x-credit-policy":"One assessment credit for new uncached work unless unlimited; cache hits and completed retries are free. Original billing receipt is preserved. Atomic result publication and reservation settlement precede delivery.","x-permissions":"Active minted account key or legacy service key with verified on-behalf identity. Captured account generation is checked again at run admission/publication. REST does not accept OAuth.","x-max-request-bytes":524288,"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UngaugedAssessmentRequest"},"examples":{"example":{"summary":"Illustrative inputs; replace with authoritative data.","value":{"descriptors":{"AREA":12.3,"SAAR":850,"BFIHOST":0.5,"DPSBAR":50,"DPLBAR":4.5,"LDP":6.3,"FARL":0.98,"FPEXT":0,"URBEXT2000":0.02,"PROPWET":0.45,"SPRHOST":35,"SAAR9120":870,"BFIHOST19scaled":0.52,"URBEXT2015":0.025,"FARL2015":0.98},"return_periods":[2,10,100],"easting":400000,"northing":300000,"idempotencyKey":"assessment-example-2"}}}}}},"responses":{"200":{"description":"Shared assessment summary, durable execution identity and original billing receipt.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UngaugedAssessmentResponse"}}}},"400":{"description":"Malformed JSON, unknown fields, invalid options or scientific inputs. Validates before billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"402":{"description":"Assessment credit is required.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["quota_exhausted"]},"404":{"description":"Account generation or retained execution is no longer available.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["not_available"]},"409":{"description":"Retry input conflict, execution already running/failed, or retention capacity reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["idempotency_conflict","run_in_progress","run_failed","run_limit_reached"]},"413":{"description":"Request exceeds the body limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["input_too_large"]},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Calculation or durable publication could not complete. Retry the same key to recover an already completed result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["analysis_failed"]},"503":{"description":"Required source is unavailable; no fabricated result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["DATA_SOURCE_UNAVAILABLE"]}}}},"/api/v1/stations/{stationId}/records":{"get":{"operationId":"getStationRecords","summary":"Read frozen station records or explicitly selected live daily data","description":"Same operation as MCP get_station_records. Choose station, amax, release_comparison, daily_flow_diagnostics, gdf or candidates. Frozen source selection is server-controlled; live GDF is separately labelled and may use the NRFA cache. Candidate flags and descriptor preflight do not perform donor/pooling selection; fetch AMAX separately for candidate station IDs. Licensed rainfall tables are never returned. Unknown/duplicate query parameters and non-decimal integer strings are rejected.","parameters":[{"name":"stationId","in":"path","required":true,"schema":{"type":"integer","exclusiveMinimum":0,"maximum":2147483647},"example":39001},{"name":"dataset","in":"query","required":true,"schema":{"type":"string","enum":["station","amax","release_comparison","daily_flow_diagnostics","gdf","candidates"]},"example":"amax"},{"name":"offset","in":"query","schema":{"default":0,"type":"integer","minimum":0,"maximum":1000000},"example":0},{"name":"limit","in":"query","schema":{"default":100,"type":"integer","minimum":1,"maximum":500},"example":100}],"x-credit-policy":"Source inspection only; no assessment, credit debit, persistence or adoption.","x-permissions":"Active minted account key or legacy service key with an active on-behalf account. Browser cookies and OAuth are not accepted.","x-max-response-bytes":2097152,"x-cache-policy":"private, no-store","responses":{"200":{"description":"Bounded source page with explicit frozen/live provenance and no credit debit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StationRecordsResponse"}}}},"400":{"description":"Invalid path, dataset or pagination; unknown/duplicate query parameters.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"404":{"description":"Station is absent from the selected frozen release, or daily diagnostics are unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["not_found","data_unavailable"]},"413":{"description":"Result exceeds 2 MiB; request a smaller page.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["result_too_large"]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected source read failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["source_read_failed"]},"503":{"description":"Required frozen source or live GDF read failed. No substitute data is returned.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["DATA_SOURCE_UNAVAILABLE"]}}}},"/api/v1/runs/{runId}":{"get":{"operationId":"getAssessmentRun","summary":"Read an owned retained assessment execution","description":"UUID path only; no query parameters. Reads the exact immutable completed execution in the current account generation/environment and retention window. Missing, expired, corrupt and foreign executions are unavailable; unfinished executions return 409. No fallback computation or save. Top-level creditConsumed is false for this read; billing records the original execution outcome. Private input options are excluded.","parameters":[{"name":"runId","in":"path","required":true,"schema":{"type":"string","format":"uuid"}}],"x-credit-policy":"Free retrieval; no new assessment or Method Space debit.","x-permissions":"Owner only; active minted account key or legacy service key with active on-behalf identity. No OAuth REST support.","x-cache-policy":"private, no-store","responses":{"200":{"description":"Recorded completed execution and its original billing/provenance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AssessmentRunResponse"}}}},"400":{"description":"Malformed run UUID or any query parameter.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"404":{"description":"Execution is not available to this owner/generation/environment/retention window.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["not_available"]},"409":{"description":"Execution is still running or failed. No new work was started.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["run_in_progress","run_failed"]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Execution storage is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["run_store_unavailable"]}}}},"/api/v1/hydrographs/design":{"post":{"operationId":"getDesignHydrographs","summary":"Read adopted design hydrograph series","description":"Calls the same shared saved-result operation as MCP. Explicit analysisId/runId only; saved visibility and owner-only retained-run expiry remain enforced. Valid subsets and up to twenty increasing stored periods are supported. Missing/killed adopted results, changed analysis-period configuration and uncovered periods are refused. ReFH1/SCS shape assumptions remain separate from adopted FEH peaks. Imported CSV requires HYDROMETRIC_FEATURE_HYDROGRAPH_SCALING; ReFH BF0 requires HYDROMETRIC_FEATURE_REFH_BASEFLOW. Fork-overlay and SEPA flags are independent and no telemetry is fetched. No fallback assessment or replacement of stored adopted design flows. Omitted periods use the stored set, normally the ten platform defaults. TUFLOW CSV uses hours and m³/s; Flood Modeller IED writes explicit HOURS. ZIP responses are base64 JSON, not binary downloads.","x-credit-policy":"Free read/export; no assessment or Method Space computation, debit or persistence.","x-permissions":"Active minted account key or valid legacy service key plus verified on-behalf identity. REST does not accept OAuth; MCP requires hydrometric:read.","x-max-request-bytes":2097152,"x-max-response-bytes":2097152,"x-work-limits":"At most 10,000 shape points and 100,000 scaled ordinates; CSV input at most 1 MiB. Configuration contains at most 20 cases/periods. The 2 MiB result limit counts UTF-8 indented MCP text, which also bounds the compact REST body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesignHydrographsRequest"},"examples":{"saved":{"summary":"Exact subset from an accessible saved adopted result.","value":{"analysisId":"YOUR_SAVED_ANALYSIS_ID","shape":"refh","returnPeriods":[2,30,100,1000],"timestepMinutes":15}},"run":{"summary":"Read a retained execution explicitly; expiry never triggers another run.","value":{"runId":"00000000-0000-4000-8000-000000000031","shape":"scs"}}}}}},"responses":{"200":{"description":"Exact shared operation payload, hashes and original scientific provenance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DesignHydrographsResponse"}}},"headers":{"Cache-Control":{"schema":{"const":"private, no-store"}}}},"400":{"description":"Unknown/contradictory inputs, malformed JSON, duplicate/unordered periods or requested period not stored.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"403":{"description":"Method Space feature entitlement is absent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["feature_not_granted"]},"404":{"description":"Unavailable/foreign/expired result, disabled imported/proxy feature, or disabled/missing frozen set.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["not_available","capability_disabled","http_404"]},"409":{"description":"Stale adopted source/configuration, unavailable shape, or absent requested sampling intervals.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["stale_analysis","method_space_stale","shape_unavailable","uncertainty_unavailable"]},"413":{"description":"Bounded request, generated ordinate count or result exceeds the export limits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["input_too_large","result_too_large"]},"415":{"description":"Request Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Stored result or export could not be read; retry the read without triggering a run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["export_unavailable"]}}}},"/api/v1/exports/model-inflows":{"post":{"operationId":"exportModelInflows","summary":"Export adopted TUFLOW/Flood Modeller inflows","description":"Calls the same shared saved-result operation as MCP. Explicit analysisId/runId only; saved visibility and owner-only retained-run expiry remain enforced. Valid subsets and up to twenty increasing stored periods are supported. Missing/killed adopted results, changed analysis-period configuration and uncovered periods are refused. ReFH1/SCS shape assumptions remain separate from adopted FEH peaks. Imported CSV requires HYDROMETRIC_FEATURE_HYDROGRAPH_SCALING; ReFH BF0 requires HYDROMETRIC_FEATURE_REFH_BASEFLOW. Fork-overlay and SEPA flags are independent and no telemetry is fetched. No fallback assessment or replacement of stored adopted design flows. Omitted periods use the stored set, normally the ten platform defaults. TUFLOW CSV uses hours and m³/s; Flood Modeller IED writes explicit HOURS. ZIP responses are base64 JSON, not binary downloads.","x-credit-policy":"Free read/export; no assessment or Method Space computation, debit or persistence.","x-permissions":"Active minted account key or valid legacy service key plus verified on-behalf identity. REST does not accept OAuth; MCP requires hydrometric:read.","x-max-request-bytes":2097152,"x-max-response-bytes":2097152,"x-work-limits":"At most 10,000 shape points and 100,000 scaled ordinates; CSV input at most 1 MiB. Configuration contains at most 20 cases/periods. The 2 MiB result limit counts UTF-8 indented MCP text, which also bounds the compact REST body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelInflowsRequest"},"examples":{"saved":{"summary":"Existing peaks and recorded sampling intervals; no Method Space spread is implied.","value":{"analysisId":"YOUR_SAVED_ANALYSIS_ID","shape":"refh","confidenceLevel":95,"returnPeriods":[2,100],"package":"full","format":"files","includeRunFiles":false}},"imported":{"summary":"Caller-supplied shape; requires the explicit imported-scaling feature flag.","value":{"analysisId":"YOUR_SAVED_ANALYSIS_ID","shape":"imported-csv","importedCsv":"hours,flow\n0,0\n1,1\n2,2\n3,1\n4,0","importedFilename":"illustrative.csv","format":"zip"}}}}}},"responses":{"200":{"description":"Exact shared operation payload, hashes and original scientific provenance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModelInflowsResponse"}}},"headers":{"Cache-Control":{"schema":{"const":"private, no-store"}}}},"400":{"description":"Unknown/contradictory inputs, malformed JSON, duplicate/unordered periods or requested period not stored.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"403":{"description":"Method Space feature entitlement is absent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["feature_not_granted"]},"404":{"description":"Unavailable/foreign/expired result, disabled imported/proxy feature, or disabled/missing frozen set.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["not_available","capability_disabled","http_404"]},"409":{"description":"Stale adopted source/configuration, unavailable shape, or absent requested sampling intervals.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["stale_analysis","method_space_stale","shape_unavailable","uncertainty_unavailable"]},"413":{"description":"Bounded request, generated ordinate count or result exceeds the export limits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["input_too_large","result_too_large"]},"415":{"description":"Request Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Stored result or export could not be read; retry the read without triggering a run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["export_unavailable"]}}}},"/api/v1/exports/simulation-set":{"post":{"operationId":"exportSimulationSet","summary":"Export frozen Method Space model inflows","description":"Calls the same shared saved-result operation as MCP. Explicit analysisId/runId only; saved visibility and owner-only retained-run expiry remain enforced. Valid subsets and up to twenty increasing stored periods are supported. Missing/killed adopted results, changed analysis-period configuration and uncovered periods are refused. ReFH1/SCS shape assumptions remain separate from adopted FEH peaks. Imported CSV requires HYDROMETRIC_FEATURE_HYDROGRAPH_SCALING; ReFH BF0 requires HYDROMETRIC_FEATURE_REFH_BASEFLOW. Fork-overlay and SEPA flags are independent and no telemetry is fetched. Requires a saved frozen simulation set, Method Space entitlement and enabled simulation sets. Rechecks its source fingerprint/hash before delivery. Existing ensemble simulation-set GET/POST reads/writes configuration; this endpoint generates its files. Cases remain central-only without BF0. Manifest requestedTimestepMinutes is distinct from actual timestepMinutes, which is null for irregular/source-preserved grids.","x-credit-policy":"Free read/export; no assessment or Method Space computation, debit or persistence.","x-permissions":"Active minted account key or valid legacy service key plus verified on-behalf identity. REST does not accept OAuth; MCP requires hydrometric:read.","x-max-request-bytes":2097152,"x-max-response-bytes":2097152,"x-work-limits":"At most 10,000 shape points and 100,000 scaled ordinates; CSV input at most 1 MiB. Configuration contains at most 20 cases/periods. The 2 MiB result limit counts UTF-8 indented MCP text, which also bounds the compact REST body.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulationSetExportRequest"},"examples":{"saved":{"summary":"Exports an already-frozen, current and entitled configuration; does not create or resolve cases.","value":{"analysisId":"YOUR_SAVED_ANALYSIS_ID","shape":"refh","package":"full","format":"zip"}}}}}},"responses":{"200":{"description":"Exact shared operation payload, hashes and original scientific provenance.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SimulationSetExportResponse"}}},"headers":{"Cache-Control":{"schema":{"const":"private, no-store"}}}},"400":{"description":"Unknown/contradictory inputs, malformed JSON, duplicate/unordered periods or requested period not stored.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"403":{"description":"Method Space feature entitlement is absent.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["feature_not_granted"]},"404":{"description":"Unavailable/foreign/expired result, disabled imported/proxy feature, or disabled/missing frozen set.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["not_available","capability_disabled","http_404"]},"409":{"description":"Stale adopted source/configuration, unavailable shape, or absent requested sampling intervals.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["stale_analysis","method_space_stale","shape_unavailable","uncertainty_unavailable"]},"413":{"description":"Bounded request, generated ordinate count or result exceeds the export limits.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["input_too_large","result_too_large"]},"415":{"description":"Request Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Stored result or export could not be read; retry the read without triggering a run.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["export_unavailable"]}}}},"/api/v1/calculation-stages":{"get":{"operationId":"listCalculationStages","summary":"Discover bounded scientific stages and held capabilities","description":"Lists exact input schemas, installed core functions, status and qualification for every registry entry. Unsupported, licensed, experimental and existing-workflow dispositions remain explicit.","x-credit-policy":"Inspection only; no debit or computation.","responses":{"200":{"description":"Capability catalog including each runtime input schema.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalculationStageCatalog"}}}},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}}}},"post":{"operationId":"calculateStage","summary":"Execute one supported calculation stage on supplied inputs","description":"Calls the same validated numerical registry as MCP calculate_stage. No source retrieval, assessment debit, persistence or automatic adoption. Caller source labels remain caller-declared-unverified. Stage identity binds resolved defaults, input, source declaration, target year, registry and engine. Research/unsupported operations cannot be activated by this endpoint.","x-credit-policy":"No assessment or Method Space debit; results are not persisted.","x-max-request-bytes":524288,"x-max-response-bytes":2097152,"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalculationStageRequest"},"examples":{"qmed":{"summary":"Synthetic annual maxima; no verified dataset claim.","value":{"stage":"qmed.amax","input":{"flows":[2,4,6,8,9,10,12,15,19,25]},"source":{"kind":"synthetic","label":"Illustrative annual maxima in m³/s"},"targetYear":2026}},"growth":{"summary":"Fit GLO growth from supplied moments with explicit periods.","value":{"stage":"growth.evaluate","input":{"distribution":"GLO","lCV":0.2,"lSkew":0.2,"returnPeriods":[2,10,100]},"source":{"kind":"synthetic","label":"Illustrative L-moments"},"targetYear":2026}}}}}},"responses":{"200":{"description":"Finite bounded result with digest, resolved inputs, source declaration and qualification.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalculationStageResult"}}}},"400":{"description":"Invalid stage input, malformed JSON or non-finite value.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalculationStageResult"}}},"x-error-codes":["invalid_input"]},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"404":{"description":"Unknown stage identifier.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalculationStageResult"}}},"x-error-codes":["unknown_stage"]},"413":{"description":"Request exceeds 512 KiB or result exceeds 2 MiB.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalculationStageResult"}}},"x-error-codes":["input_too_large","result_too_large"]},"422":{"description":"Held operation, unsupported scientific domain or invalid numerical result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CalculationStageResult"}}},"x-error-codes":["unsupported_stage","domain_error","invalid_result"]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}}}}},"/api/v1/estimate":{"post":{"operationId":"estimateUngauged","summary":"Compute an ungauged FEH statistical estimate","description":"Direct descriptors are MANUAL inputs. Requires site coordinates; an optional centroid must be supplied as a pair. Only documented top-level fields are supported. The response uses canonical selectedBranch and API version 1.2; other calculated branches and recorded provenance remain available.","x-credit-policy":"Unmetered service estimate; no assessment or Method Space credit is consumed.","x-permissions":"Valid minted account key or legacy service key. No OAuth scope is accepted by the v1 proxy.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EstimateRequest"},"examples":{"synthetic":{"summary":"Illustrative request; replace with authoritative descriptors and coordinates.","value":{"descriptors":{"AREA":12.3,"SAAR":850,"BFIHOST":0.5,"DPSBAR":50,"DPLBAR":4.5,"LDP":6.3,"FARL":0.98,"FPEXT":0,"URBEXT2000":0.02,"PROPWET":0.45,"SPRHOST":35,"SAAR9120":870,"BFIHOST19scaled":0.52,"URBEXT2015":0.025,"FARL2015":0.98},"return_periods":[2,10,100],"easting":400000,"northing":300000}}}}}},"responses":{"200":{"description":"Canonical estimate; flows in m³/s and periods in years.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EstimateResponse"}}}},"400":{"description":"Malformed JSON, unsupported fields or invalid/missing scientific inputs. Required AREA/SAAR retain named errors; other missing descriptors are listed together.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Calculation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["analysis_failed"]},"503":{"description":"Required flow source is unavailable; no fabricated result.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["DATA_SOURCE_UNAVAILABLE"]}}}},"/api/v1/method-space":{"post":{"operationId":"runMethodSpace","summary":"Compute or replay a Method Space comparison","description":"Exactly one subject: stationId, accessible analysisId, or descriptors with coordinates. Send application/json with no query parameters, within the 512 KiB body limit. Validates before billing. Saved paid fingerprints replay without a new debit; unsaved inputs still require admission. Stale saved analyses are rejected. Response figure data is inline.","x-credit-policy":"One Method Space credit per distinct paid calculation unless exempt/already paid. A station subject can also consume one assessment credit.","x-permissions":"Active minted account key or legacy service key with verified on-behalf identity; REST does not accept OAuth. Captured account generation is checked under the wallet lock and before delivery. Saved subjects must be accessible.","x-max-request-bytes":524288,"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MethodSpaceRequest"},"examples":{"station":{"value":{"stationId":39001,"includeImage":false},"summary":"A station run may also consume an assessment credit."},"saved":{"value":{"analysisId":"YOUR_SAVED_ANALYSIS_ID","includeImage":false},"summary":"Only an accessible, current saved result can replay an already-paid calculation with no wallet balance."},"ungauged":{"value":{"descriptors":{"AREA":12.3,"SAAR":850,"BFIHOST":0.5,"DPSBAR":50,"DPLBAR":4.5,"LDP":6.3,"FARL":0.98,"FPEXT":0,"URBEXT2000":0.02,"PROPWET":0.45,"SPRHOST":35,"SAAR9120":870,"BFIHOST19scaled":0.52,"URBEXT2015":0.025,"FARL2015":0.98},"easting":400000,"northing":300000,"includeImage":false},"summary":"Illustrative descriptors; supply your own authoritative inputs."}}}}},"responses":{"200":{"description":"Method-space alternatives and explicit billing outcome.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MethodSpaceResponse"}}}},"400":{"description":"Closed request validation failed before billing.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"402":{"description":"Required credit is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["method_space_credit_required","quota_exhausted"]},"404":{"description":"Saved analysis is missing/inaccessible or the admitted account generation is no longer available.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["not_found","not_available"]},"409":{"description":"Saved result is stale, no method-valid variants exist, or station assessment execution cannot be admitted.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["analysis_stale","no_variants","run_in_progress","run_failed","idempotency_conflict","run_limit_reached","invalid_input"]},"413":{"description":"Request exceeds the body limit.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["input_too_large"]},"415":{"description":"Content-Type must be application/json.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Method Space failed; retry the same request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["method_space_failed"]}}}},"/api/v1/ddf/point":{"post":{"operationId":"queryNationalDdfPoint","summary":"Query national point rainfall depths","description":"EPSG:27700 coordinates; duration 0.25–240 hours and return period 2–1000 years. Requires an admitted national release; response release metadata controls maturity and design-use claims.","x-credit-policy":"No assessment or Method Space debit.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NationalDDFPointRequest"},"examples":{"synthetic":{"value":{"easting":430000,"northing":180000,"durationHours":1,"returnPeriod":100}}}}}},"responses":{"200":{"description":"Rainfall depths in millimetres with release identity.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NationalDDFPointResponse"}}}},"400":{"description":"Malformed or invalid request.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"422":{"description":"Query outside the supported product domain.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_query","outside_support"]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"No admissible national release is available.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["release_unavailable"]}}}},"/api/v1/ddf/catchment/critical-duration":{"post":{"operationId":"findNationalDdfCriticalDuration","summary":"Evaluate catchment critical duration using national rainfall","description":"EPSG:27700 Polygon/MultiPolygon plus authoritative descriptors. Validates polygon identity, vertex/coordinate limits and AREA agreement. Rainfall release maturity is retained. The ReFH-type engine uses published ReFH1 research coefficients, without licensed ReFH2 equivalence.","x-credit-policy":"No assessment or Method Space debit.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/NationalDDFCriticalDurationRequest"},"examples":{"synthetic":{"value":{"geometry":{"type":"Polygon","coordinates":[[[100000,200000],[101000,200000],[101000,201000],[100000,201000],[100000,200000]]]},"descriptors":{"AREA":1,"DPLBAR":1.2,"DPSBAR":50,"LDP":1.6,"SAAR":900,"BFIHOST":0.45,"PROPWET":0.4,"SPRHOST":35,"URBEXT2000":0.05,"FARL":1,"FPEXT":0.1},"returnPeriod":100,"season":"winter"}}}}}},"responses":{"200":{"description":"Critical duration (hours), design event and release identity.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NationalDDFCriticalDurationResponse"}}}},"400":{"description":"Malformed descriptors, coordinates, geometry or AREA mismatch.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_input"]},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"422":{"description":"Unsupported query or a catchment the computational grid cannot resolve.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_query","outside_support","catchment-unresolvable"]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}},"503":{"description":"No admissible national release is available.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["release_unavailable"]}}}},"/api/v1/analysis/{analysisId}":{"get":{"operationId":"getSavedAnalysis","summary":"Read the analyst-adopted saved analysis","parameters":[{"name":"analysisId","in":"path","required":true,"description":"An existing saved analysis visible to the acting account.","schema":{"type":"string","minLength":1},"example":"YOUR_SAVED_ANALYSIS_ID"}],"description":"Resolves adopted forks and stored periods through the same report builder. Reading does not rerun the engine. Old results keep their recorded versions and provenance.","x-credit-policy":"Read only; no debit.","x-permissions":"Acting account must be owner, project grantee, team member or authorized admin.","responses":{"200":{"description":"Saved metadata, fork-resolved result and comparison routes.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SavedAnalysisResponse"}}}},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"403":{"description":"The acting account cannot view this saved analysis.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"404":{"description":"Saved analysis or calculated payload not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Saved analysis serialization failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]}}}},"/api/v1/analysis/{analysisId}/audit-record":{"get":{"operationId":"getSavedAnalysisAuditRecord","summary":"Download the current adopted audit record or immutable signed snapshot","parameters":[{"name":"analysisId","in":"path","required":true,"description":"An existing saved analysis visible to the acting account.","schema":{"type":"string","minLength":1},"example":"YOUR_SAVED_ANALYSIS_ID"},{"name":"record","in":"query","required":false,"schema":{"type":"string","enum":["current","signed"],"default":"current"}}],"description":"Current records resolve the same hydrograph and map provenance as the report. A missing current map artifact is refused rather than omitted. record=signed returns the exact stored canonical JSON after hash verification, without rebuilding or migrating historical evidence; generatedAt may be absent from signed canonical records.","x-credit-policy":"Read only; no debit.","x-permissions":"Same saved-analysis visibility as the analysis read.","responses":{"200":{"description":"Machine-readable audit record from the shared saved-report builder.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisAuditRecord"}}},"headers":{"Content-Disposition":{"schema":{"type":"string"},"description":"attachment with a generated JSON filename."},"X-Hydrometric-Audit-Record-Source":{"schema":{"enum":["current-analysis","signed-snapshot"]}},"X-Hydrometric-Audit-Record-Hash":{"schema":{"type":"string"},"description":"Canonical audit record SHA-256."},"X-Hydrometric-Audit-Record-Schema-Version":{"schema":{"type":"string"}},"X-Hydrometric-Signoff-Id":{"schema":{"type":"string"},"description":"Present only for a signed snapshot."}}},"400":{"description":"Unsupported record selector.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["invalid_record_kind"]},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"403":{"description":"The acting account cannot view this saved analysis.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"404":{"description":"Saved analysis or requested signed snapshot is unavailable.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["signed_record_unavailable"]},"409":{"description":"Missing current map provenance or stored signed snapshot integrity failure.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["report_map_unavailable","signed_record_integrity_failed"]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Audit record generation failed.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"503":{"description":"Audit provenance lookup failed or timed out.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":["audit_provenance_unavailable","audit_provenance_timeout"]}}}},"/api/v1/analysis/{analysisId}/status":{"get":{"operationId":"getSavedAnalysisStatus","summary":"Read sign-offs, reviews and comments","parameters":[{"name":"analysisId","in":"path","required":true,"description":"An existing saved analysis visible to the acting account.","schema":{"type":"string","minLength":1},"example":"YOUR_SAVED_ANALYSIS_ID"}],"x-credit-policy":"Read only; no debit.","x-permissions":"Same saved-analysis visibility as the analysis read.","responses":{"200":{"description":"Current access-checked collaboration state.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/AnalysisStatusResponse"}}}},"401":{"description":"Missing, invalid or inactive API credential. Legacy service auth fails closed in production.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"403":{"description":"The acting account cannot view this saved analysis.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"404":{"description":"Saved analysis or calculated payload not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[]},"429":{"description":"Per-process request limit reached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}},"x-error-codes":[],"headers":{"Retry-After":{"description":"Seconds until this process permits a retry.","schema":{"type":"integer","minimum":1}}}},"500":{"description":"Unexpected storage/action failure; no stable error body is guaranteed."}}}}}}