Profil de sol actuel (horizons)

GET /parcels/{id}/soil-profile

• Scope agronomy:read
• Clé API x-api-key
• URL de base https://api.hub.akuasense.com/v1

Paramètres de chemin

• id integer obligatoire

Réponse

200

Horizons en vigueur, du haut vers le bas ; liste vide si rien n’est déclaré

• data tableau de SoilProfileLayer toujours présent

  Un horizon du profil de sol déclaré sur la parcelle.

  Afficher les 10 attributs Masquer les attributs

  • id integer toujours présent

    Identifiant de la déclaration.

  • parcel_id integer toujours présent
  • soil_horizon_id integer toujours présent

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

  • depth_top_cm integer toujours présent

    Haut de l’horizon, en cm (0 = surface).

  • depth_bottom_cm integer toujours présent

    Bas de l’horizon, en cm.

  • timestamp_start string date-time toujours présent

    Date de la déclaration.

  • horizon_name string toujours présent

    Nom de l’horizon, invariable (en anglais).

  • usda_class string toujours présent

    Classe texturale USDA (voir SoilHorizonReference).

  • theta_fc number toujours présent

    Teneur en eau volumique à la capacité au champ, m³/m³.

  • theta_pwp number toujours présent

    Teneur en eau volumique au point de flétrissement permanent, m³/m³.

Erreurs

• 400

  Paramètre invalide

  invalid_id
• 401

  Non authentifié

• 403

  Scope insuffisant ou ressource hors société

GET /parcels/{id}/soil-profile

cURL JavaScript Python

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

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

import requests

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

Réponse

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 · exemple généré depuis le schéma

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

application/problem+json · exemple généré depuis le schéma

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

application/problem+json · exemple généré depuis le schéma