Current soil profile (horizons)

GET /parcels/{id}/soil-profile

• Scope agronomy:read
• API key x-api-key
• Base URL https://api.hub.akuasense.com/v1

Path parameters

• id integer required

Response

200

Horizons in force, top down; empty list if nothing is declared

• data array of SoilProfileLayer always present

  One horizon of the soil profile declared on the parcel.

  Show 10 attributes Hide attributes

  • id integer always present

    Identifier of the declaration.

  • parcel_id integer always present
  • soil_horizon_id integer always present

    Horizon: code from GET /reference/soil-horizons.

  • depth_top_cm integer always present

    Top of the horizon, in cm (0 = surface).

  • depth_bottom_cm integer always present

    Bottom of the horizon, in cm.

  • timestamp_start string date-time always present

    Date of the declaration.

  • horizon_name string always present

    Name of the horizon, invariable (in English).

  • usda_class string always present

    USDA textural class (see SoilHorizonReference).

  • theta_fc number always present

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

  • theta_pwp number always present

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

Errors

• 400

  Invalid parameter

  invalid_id
• 401

  Not authenticated

• 403

  Insufficient scope, or resource outside your company

GET /parcels/{id}/soil-profile

cURL JavaScript Python

curl https://api.hub.akuasense.com/v1/parcels/1/soil-profile \
  -H "x-api-key: YOUR_API_KEY"

const response = await fetch(
  'https://api.hub.akuasense.com/v1/parcels/1/soil-profile',
  {
    headers: {
      'x-api-key': 'YOUR_API_KEY',
    },
  },
);
const data = await response.json();

import requests

response = requests.get(
    "https://api.hub.akuasense.com/v1/parcels/1/soil-profile",
    headers={"x-api-key": "YOUR_API_KEY"},
)
data = response.json()

Response

200 400 401 403

{
  "data": [
    {
      "id": 12,
      "parcel_id": 44,
      "soil_horizon_id": 5,
      "depth_top_cm": 0,
      "depth_bottom_cm": 30,
      "timestamp_start": "2026-09-11T08:30:00.000Z",
      "horizon_name": "Loam",
      "usda_class": "Loam",
      "theta_fc": 0.269,
      "theta_pwp": 0.126
    },
    {
      "id": 13,
      "parcel_id": 44,
      "soil_horizon_id": 12,
      "depth_top_cm": 30,
      "depth_bottom_cm": 60,
      "timestamp_start": "2026-09-11T08:30:00.000Z",
      "horizon_name": "Clay",
      "usda_class": "Clay",
      "theta_fc": 0.451,
      "theta_pwp": 0.34
    }
  ]
}

application/json

{
  "type": "string",
  "title": "string",
  "status": 400,
  "detail": "string",
  "code": "invalid_id"
}

application/problem+json · example generated from the schema

{
  "type": "string",
  "title": "string",
  "status": 401,
  "detail": "string",
  "code": "string"
}

application/problem+json · example generated from the schema

{
  "type": "string",
  "title": "string",
  "status": 403,
  "detail": "string",
  "code": "string"
}

application/problem+json · example generated from the schema