Horton soil infiltration API

Computes instantaneous and cumulative soil infiltration after time t via Horton's exponential-decay equation from initial/final rates and a decay constant. Answers 'What is the infiltration rate after 1 hour?', 'How much water has soaked in by now?'.

Price$0.06per request

MethodPOST

Route/v1/climate/soil-infiltration

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

infiltrationhortonsoilhydrologydrainagepercolationcivilgroundwater

API URLhttps://x402.hexl.dev/v1/climate/soil-infiltration

Integration docs

Example request

{
  "initialRateMmHr": 50,
  "finalRateMmHr": 10,
  "decayConstant": 2,
  "timeHr": 1
}

Example response

{
  "infiltrationRateMmHr": 15.413,
  "cumulativeInfiltrationMm": 27.293,
  "initialRateMmHr": 50,
  "finalRateMmHr": 10,
  "decayConstant": 2,
  "timeHr": 1,
  "interpretation": "At t=1 h: rate 15.41 mm/hr, total infiltrated 27.3 mm.",
  "formula": "Horton: f(t)=fc+(f0−fc)·e^(−kt); F(t)=fc·t+(f0−fc)/k·(1−e^(−kt))"
}

Input schema

{
  "type": "object",
  "required": [
    "initialRateMmHr",
    "finalRateMmHr",
    "decayConstant",
    "timeHr"
  ],
  "properties": {
    "initialRateMmHr": {
      "type": "number",
      "description": "Initial infiltration rate f0 (mm/hr)",
      "examples": [
        50
      ]
    },
    "finalRateMmHr": {
      "type": "number",
      "description": "Final/steady rate fc (mm/hr)",
      "examples": [
        10
      ]
    },
    "decayConstant": {
      "type": "number",
      "description": "Decay constant k (1/hr)",
      "examples": [
        2
      ]
    },
    "timeHr": {
      "type": "number",
      "description": "Elapsed time (hr)",
      "examples": [
        1
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}