Fertiliser Price API

Quick start

Every endpoint is a plain GET over HTTPS. Nothing to sign up for, and no header is required. This returns today's estimate for all nine grades.

{
  "provider": {
    "name": "Tilth",
    "legal_name": "Diligo Ltd",
    "url": "https://www.tilth.uk",
    "contact": "[email protected]"
  },
  "dataset": {
    "name": "Tilth UK fertiliser price index",
    "description": "Independent UK Fertiliser Price Index & Exchange",
    "documentation_url": "https://www.tilth.uk/data/",
    "openapi_url": "https://www.tilth.uk/api/v1/public/fertiliser/openapi.json"
  },
  "license": {
    "name": "CC BY 4.0",
    "spdx": "CC-BY-4.0",
    "url": "https://creativecommons.org/licenses/by/4.0/",
    "attribution": "Tilth (www.tilth.uk)",
    "usage": "Free to read, quote, republish and build on, with attribution. Not an offer, quote, or transaction price."
  },
  "schema_version": "1.0",
  "unit": "GBP/tonne",
  "currency": "GBP",
  "disclaimer": "An estimate of the prevailing UK market price, not a quote or an offer to trade.",
  "generated_at": "2026-07-23T06:12:04.918273611+00:00",
  "as_of": "2026-07-23",
  "count": 9,
  "data": [
    {
      "product": "AN_UK",
      "estimate_gbp_t": 436.5,
      "band_low_gbp_t": 420.88,
      "band_high_gbp_t": 452.11,
      "as_of": "2026-07-23",
      "method": "modelled",
      "within_gbp_t": 6.25,
      "hit_rate_n_of_10": 8,
      "signal_stage": "early"
    }
  ],
  "links": {
    "self": "https://www.tilth.uk/api/v1/public/fertiliser/latest",
    "all_latest": "https://www.tilth.uk/api/v1/public/fertiliser/latest",
    "documentation": "https://www.tilth.uk/data/",
    "license": "https://creativecommons.org/licenses/by/4.0/"
  }
}

Endpoints

Absolute paths against the base URL above. All four accept GET only.

Response envelope

The latest and dataset endpoints wrap their points in the same self-describing envelope, so an agent reading one response knows the unit, the licence and the vintage without consulting this page.

Estimate point

Every entry in the data array carries these fields.

Product codes

Pass one of these as the product parameter. Anything else returns a 400.

Errors

Failures return the status code below with a JSON body. The endpoints are rate limited per IP, so a polite client should cache rather than poll in a loop.

Use Tilth from an AI agent

Tilth also runs a Model Context Protocol server, so an agent can call the index directly as a tool instead of you wiring up the HTTP calls above by hand.

{
  "mcpServers": {
    "tilth": {
      "url": "https://www.tilth.uk/mcp"
    }
  }
}

Tools

The server exposes six tools. Five are read-only; the sixth needs the user's explicit consent before it does anything.

list_products

Lists the nine fertiliser grades the index tracks, with their product codes.

get_fertiliser_price

Returns the current price estimate for one grade, with its confidence band.

get_price_history

Returns the daily price history for one grade, newest first.

compare_forecast_to_defra

Rebases the forecast against the official DEFRA Agricultural Price Index for one grade.

compare_quote_to_index

Compares a quoted price per tonne against the current index estimate for one grade.

subscribe_price_alert

Consent-gated: subscribes an email to a price alert only once the user has clearly agreed to it. Tilth sends a confirmation link first, and the alert activates only when the user clicks it.

Licence and attribution

The data is published under Creative Commons Attribution 4.0. You may republish it, chart it, and build a commercial product on it. You must credit the index, and you must not present the numbers as anything other than estimates.