Skip to main content

Documentation Index

Fetch the complete documentation index at: https://api.superseeded.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

The pot size validation API uses “Growth Equivalent” logic to map raw container labels (like “400mm AS” or “20L Planter Bag”) to standardized maturity stages.

​
The problem

Legacy systems rely on exact string matching. This affects the supply chain because:
  • Units differ: Litres (Volume) vs. Millimeters (Diameter).
  • Formats differ: “Pot”, “Bag”, “Tubestock”, “Planter Bag”.
  • Abbreviations are common: “AS” (Air Slot), “RP” (Root Pruning), “XG” (Ex-Ground).

​
The solution: Growth equivalents

When you send a list of strings to /v1/verify/pot-sizes, the API maps them to a stage of maturity (0-5). This allows you to determine if two items are swappable.

​
The maturity hierarchy

StageNameExamplesSubstitution logic
0GeneticSeeds, Tissue CultureNot a plant yet.
1PropagationJiffy, Plugs, CuttingsProduction inputs. High transplant risk.
2LinersTubes, Cell Trays, PunnetsStackable freight. “Potting up” stock.
3Retail140mm - 300mm PotsStandard rigid containers. Pallet freight.
4Advanced45L Bags, Air PotsLandscape construction stock.
5MatureEx-Ground, 100L+Heavy machinery required.

​
Additional metadata

The API returns metadata for logistics and risk management.

​
1. Logistics information

The API flags freight constraints.
Scenario: A “Standard Tube” is flagged as is_stackable: true. A “200mm Pot” is is_stackable: false. Value: Applications can calculate that shipping 1,000 tubes is less expensive than shipping 1,000 pots.

​
2. Quality and risk profiles

The API provides information on handling and perishability.
Scenario: You validate a “Bare Root” tree. Response: The API returns transplant_shock_risk: "High" and seasonal_restriction: "Winter Only". Value: You can display a warning in your UI: “Warning: This item is perishable and only available in Winter.”

​
Example request

curl -X POST https://api.superseeded.ai/v1/verify/pot-sizes \
  -H "X-API-Key: sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "items": [
      "400mm AS",
      "20L Planter Bag"
    ]
  }'

​
Example response

{
  "results": [
    {
      "input_label": "400mm AS",
      "match_confidence": "Medium",
      "standard_data": {
        "id": "3.2",
        "evergreen_connect_potsize_id": [
          606,693,707,838,753,775,509,832,556,533,755,541,560,786,780,656
        ],
        "type": "Pot - Square",
        "stage_order": 3,
        "stage_name": "Retail & Small Production",
        "is_biological": true,
        "matching_strategy": "Volume/Width",
        "logistics": {
          "tier": "Pallet",
          "is_stackable": false,
          "freight_efficiency": "Medium-High"
        },
        "quality_profile": {
          "transplant_shock_risk": "Low",
          "seasonal_restriction": "None",
          "inspection_focus": "Root Circling"
        },
        "customer_note": "More volume efficient than round pots; fits tighter on pallets."
      },
      "external_ids": null
    },
    {
      "input_label": "20L Planter Bag",
      "match_confidence": "High",
      "standard_data": {
        "id": "4.2",
        "evergreen_connect_potsize_id": [
          730
        ],
        "type": "Planter Bag",
        "stage_order": 4,
        "stage_name": "Advanced Production",
        "is_biological": true,
        "matching_strategy": "Volume",
        "logistics": {
          "tier": "Pallet",
          "is_stackable": false,
          "freight_efficiency": "High"
        },
        "quality_profile": {
          "transplant_shock_risk": "Low",
          "seasonal_restriction": "None",
          "inspection_focus": "Weeds/Slugs"
        },
        "customer_note": "Cheaper equivalent to pots; bags can be squashed during transit."
      },
      "external_ids": null
    }
  ]
}