Skip to main content
POST
/
verify
/
pot-sizes
Resolve Specs
curl --request POST \
  --url https://api.superseeded.ai/v1/verify/pot-sizes \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-API-Key: <api-key>' \
  --form file='@example-file' \
  --form extraction_type=pot_sizes
{
  "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
    }
  ]
}
Classify plant pot sizes and specifications using Growth Equivalent logic. Maps raw text labels to a stage of maturity (0-5) to determine if items are swappable.

​
Input Options

This endpoint accepts input in three ways:

​
1. JSON Body with Items Array

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"]}'

​
2. JSON Body with File URL (TUS Upload)

For files uploaded via TUS protocol: 
curl -X POST https://api.superseeded.ai/v1/verify/pot-sizes \
  -H "Authorization: Bearer <delegation_token>" \
  -H "Content-Type: application/json" \
  -d '{"file_url": "https://secure.superseeded.ai/files/abc123", "filename": "data.xlsx"}'

​
3. Direct File Upload (Multipart)

Upload files directly without TUS - reduces round trips for Basic/Pro plans: 
curl -X POST https://api.superseeded.ai/v1/verify/pot-sizes \
  -H "X-API-Key: sk_..." \
  -F "file=@data.xlsx" \
  -F "extraction_type=pot_sizes"

​
Request Body (JSON)

​
items
string[]
An array of raw plant specification strings to be resolved. Takes precedence over file inputs.
​
file_url
file
URL to a previously uploaded file (from TUS storage). Must be from secure.superseeded.ai or api.superseeded.ai.Tip: You can use the file input dialog in this playground to test with a local file.
​
filename
string
Optional filename hint for format detection when using file_url.
​
extraction_type
string
default:"pot_sizes"
What to extract from files: pot_sizes, species, or generic.

​
Form Fields (Multipart)

​
file
file
Direct file upload. Supported formats: JSON, XLSX, XLS, PDF, TXT, PNG, JPG, JPEG, GIF, WEBP.
​
extraction_type
string
default:"pot_sizes"
What to extract from the file.

​
Authentication

PlanAuth MethodHeader
Basic/ProAPI KeyX-API-Key: sk_...
Teams (platform)Delegation TokenAuthorization: Bearer <token>
Basic/Pro plans can use direct API key authentication for all input methods including direct file upload. Teams plans with platform integration require a delegation token obtained via POST /v1/auth/delegate-upload. This ensures each request is attributed to the correct merchant for billing.

​
Supported File Formats

FormatExtensionsProcessing
JSON.jsonDirect parsing of items array
Excel.xlsx, .xlsText extraction from cells
PDF.pdfText extraction
Text.txtDirect text processing
Images.png, .jpg, .jpeg, .gif, .webpAI vision extraction
{
  "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
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

Standard API Key authentication.

Body

Object containing a list of raw spec strings to be resolved, file reference, or direct file upload.

​
file
file

File to upload. Supported formats: JSON, XLSX, XLS, PDF, TXT, PNG, JPG, JPEG, GIF, WEBP.

​
extraction_type
enum<string>
default:pot_sizes

What to extract from the file.

Available options:
pot_sizes,
species,
generic

Response

Successful resolution with detailed hierarchy data.

​
results
object[]