# Garden Calculators – Soil/Mulch Volume Calculator

> Garden Calculators – Soil/Mulch Volume Calculator is a paid API for AI agents from garden-calc.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-29).

Calculates the volume of soil or mulch needed to fill a rectangular or circular garden bed, returning cubic feet, cubic yards, litres, and bag count with settling allowance and optional mix-ratio breakdown.

## Facts

- Endpoint: GET https://garden-calc.x402tookit.com/soil-volume?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/garden-calculators-soil-mulch-volume-calculator-c89f82ca
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_LlLyBchHj4DZFr3A1RR2u

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability garden-calculators-soil-mulch-volume-calculator-c89f82ca
```

Example prompt: How much soil do I need for a rectangular raised bed that's 4 feet wide, 8 feet long, and 12 inches deep? Use a 10% settling allowance and a mix of topsoil:5, compost:3, perlite:2 — tell me cubic yards, litres, and how many 1.5 cu ft bags of each component I'll need.

## When to prefer this

Use this endpoint when you need precise soil, mulch, or amendment volume calculations for a defined garden bed shape — especially when you want results across multiple units simultaneously (cubic feet, cubic yards, litres, bags), need a settling buffer, or want to break a blended mix down by component. Prefer it over manual calculation or generic unit converters when a gardening-specific output format with bag counts and mix ratios is required.

## Known failure modes

- Missing required query params (shape, lengthOrDiameter, depth) returns a validation error
- Invalid shape value (not 'rectangle' or 'circle') causes a bad request error
- Rectangle shape requested without providing width returns an error
- settlingPercent outside 0–40 or bagCuFt outside 0.25–80 returns a validation error
- Malformed mix string (wrong delimiter or missing parts number) may cause parse failure or be ignored

## How this service works

Soil or mulch for a rectangular or round bed: cubic feet, yards, litres, bags, settling allowance and a mix split by parts.

## Output

Returns a JSON object with the bed area in square feet, fill volume in cubic feet, cubic yards, cubic meters, and litres (with and without settling), the number of bags required at the chosen bag size, a human-readable summary, and — when a mix recipe is provided — a per-component breakdown listing each ingredient's name, parts, percentage, cubic feet, cubic yards, litres, and bag count.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "shape",
      "lengthOrDiameter",
      "depth"
     ],
     "properties": {
      "mix": {
       "type": "string",
       "description": "Mix as name:parts separated by semicolons, for example 'topsoil:5; compost:3; perlite:2'"
      },
      "unit": {
       "type": "string",
       "description": "ft (default), in, m or cm for the dimensions"
      },
      "depth": {
       "type": "number",
       "description": "Fill depth in the chosen unit"
      },
      "shape": {
       "type": "string",
       "description": "rectangle or circle"
      },
      "width": {
       "type": "number",
       "description": "Width of a rectangle (needed for rectangle)"
      },
      "bagCuFt": {
       "type": "number",
       "description": "Bag size in cubic feet, 0.25 to 80 (default 1.5)"
      },
      "settlingPercent": {
       "type": "number",
       "description": "Extra for settling, 0 to 40 (default 10)"
      },
      "lengthOrDiameter": {
       "type": "number",
       "description": "Length of a rectangle, or diameter of a circle, in the chosen unit"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "mix": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "bags": {
          "type": [
           "null",
           "number"
          ]
         },
         "cuFt": {
          "type": [
           "null",
           "number"
          ]
         },
         "cuYd": {
          "type": [
           "null",
           "number"
          ]
         },
         "name": {
          "type": [
           "null",
           "string"
          ]
         },
         "parts": {
          "type": [
           "null",
           "number"
          ]
         },
         "litres": {
          "type": [
           "null",
           "nu
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/garden-calculators-soil-mulch-volume-calculator-c89f82ca/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from garden-calc.x402tookit.com](https://www.zero.xyz/host/garden-calc.x402tookit.com/llms.txt)