Verify Pot Sizes

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)

string[]

An array of raw plant specification strings to be resolved. Takes precedence over file inputs.

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.

string

Optional filename hint for format detection when using file_url.

string

default:"pot_sizes"

What to extract from files: pot_sizes, species, or generic.

Form Fields (Multipart)

file

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

string

default:"pot_sizes"

What to extract from the file.

Authentication

Plan	Auth Method	Header
Basic/Pro	API Key	`X-API-Key: sk_...`
Teams (platform)	Delegation Token	`Authorization: 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

Format	Extensions	Processing
JSON	`.json`	Direct parsing of items array
Excel	`.xlsx`, `.xls`	Text extraction from cells
PDF	`.pdf`	Text extraction
Text	`.txt`	Direct text processing
Images	`.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`	AI 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
    }
  ]
}

API documentation

Endpoints

Input Options

1. JSON Body with Items Array

2. JSON Body with File URL (TUS Upload)

3. Direct File Upload (Multipart)

Request Body (JSON)

Form Fields (Multipart)

Authentication

Supported File Formats

​Input Options

​1. JSON Body with Items Array

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

​3. Direct File Upload (Multipart)

​Request Body (JSON)

​Form Fields (Multipart)

​Authentication

​Supported File Formats

Input Options

1. JSON Body with Items Array

2. JSON Body with File URL (TUS Upload)

3. Direct File Upload (Multipart)

Request Body (JSON)

Form Fields (Multipart)

Authentication

Supported File Formats