Skip to content
docs

Soil horizons (texture, USDA, theta_*)

GET /reference/soil-horizons
  • Scope catalog:read
  • API key x-api-key
  • Base URL https://api.hub.akuasense.com/v1

Query parameters

  • lang string

    Language of the label fields, and of a probe’s default name (name: “Probe 3”, “Sonde 3”). The code values never vary. A crop with no translation falls back to its French name.

    Values: enfr
    Default: en

Response

200

USDA catalog, by decreasing sand content

  • data array of SoilHorizonReference always present

    A USDA textural class from the shared catalog, with its hydraulic constants, estimated by pedotransfer (Saxton & Rawls 2006) for 2.5 % organic matter. Soil analyses specific to a company never appear here.

    Show 9 attributes Hide attributes
    • code string always present

      Stable identifier of the horizon. This is the value to pass, as an integer, in soilHorizonId of PUT /parcels/{id}/soil-profile.

    • label string always present

      Textural class in the requested language (lang).

    • usda_class string always present

      USDA textural class, in English and invariable: this is the one an integration stores.

      Values: SandLoamy sandSandy loamSandy clay loamLoamSilt loamSiltClay loamSilty clay loamSandy claySilty clayClay
    • theta_sat number always present

      Volumetric water content at saturation, in m³/m³.

    • theta_fc number always present

      Volumetric water content at field capacity, in m³/m³.

    • theta_pwp number always present

      Volumetric water content at the permanent wilting point, in m³/m³.

    • sand_pct number always present

      Share of sand, in %. Sand + silt + clay = 100.

    • silt_pct number always present

      Share of silt, in %.

    • clay_pct number always present

      Share of clay, in %.

Errors

  • 401

    Not authenticated

  • 403

    Insufficient scope, or resource outside your company