API Report Card →

← Back to all docs

Trellis (BlueCircle) API

Trellis (BlueCircle) is an AI-powered food system intelligence platform that forecasts block-level yield, crop quality, and harvest timing across the agricultural supply chain for food and beverage producers and their growers. An unofficial API lets you programmatically pull yield and quality forecasts, field and block measurements, harvest schedules, grower and supplier records, and supply-vs-demand insights—and push production plans, sourcing targets, and delivery data back into the platform.

By Alex Klarfeld•May 30, 2026

What is Trellis (BlueCircle)?

Trellis (now branded BlueCircle, formerly ATP Labs) is an AI-powered food system intelligence platform that closes the gap between growers and food & beverage companies. It ingests field measurements, crop and weather observations, factory and warehouse deliveries, production plans, and financial data from across the agricultural ecosystem to forecast block-level yield, crop quality, and harvest timing. Food and beverage producers use it to optimize unit cost, eliminate waste, and balance supply against demand across an ever-changing climate and market environment.

Core platform areas include:

  • Supply Chain Insights (block- and appellation-level yield and crop performance against historical averages)
  • Supply Prediction (early-season forecasts of yield, quality, and timing of harvest)
  • Intelligent Coordination Layer (real-time optimization across demand, production, inventory, logistics, product mix, and sustainability)
  • Data integration engine (ingests data from legacy ERP, SCM, and WMS systems with normalization, outlier detection, and ML-based imputation)

Common data entities:

  • Fields, Blocks, Appellations, Regions, Crops
  • Yield Forecasts, Quality Attributes, Harvest Timing Predictions
  • Field Measurements, Crop and Weather Observations, Field Operations (irrigation, fertilization, spraying)
  • Growers, Suppliers, Sourcing Targets
  • Deliveries, Production Plans, Inventory, Demand Forecasts
  • Outlier Alerts, Risk Signals, Financial and Cost Data

The Trellis (BlueCircle) Integration Challenge

Food and beverage operators run sourcing and production decisions on Trellis daily, but turning its forecasts and insights into API-driven automation is non-trivial:

  • No public developer API: forecasts and insights are delivered through a SaaS dashboard and customer-specific deliveries, with no documented self-serve endpoints
  • Customer-specific models: predictions are tuned per client, crop, and region, so a generic integration breaks across tenants and verticals (wine, coffee, barley, wheat, fruit)
  • Heterogeneous upstream data: field measurements, weather, deliveries, production plans, and financials arrive in different formats from many growers and legacy systems
  • Block- and appellation-level granularity: yield and quality predictions are scoped to fine-grained blocks and appellations that must be mapped to your own field and sourcing hierarchy
  • Time-sensitive harvest windows: forecasts shift as the season progresses, so automation must pull fresh predictions rather than cache stale ones
  • Authentication and session handling: portal access is built for human analysts, complicating headless, scheduled automation

How Supergood Creates Trellis (BlueCircle) APIs

Supergood reverse-engineers Trellis's authenticated browser flows and data deliveries to deliver a resilient API layer for your tenant—so you can pull forecasts and push sourcing and production data without waiting on a partner integration.

  • Handles username/password and MFA (SMS, email, TOTP) securely in a managed session
  • Maintains session continuity with automated refresh and change detection
  • Normalizes responses across yield forecasts, quality attributes, field measurements, and grower records so you integrate once against consistent objects
  • Maps block- and appellation-level predictions to your own field, sourcing, and production hierarchy

Use Trellis (BlueCircle) with AI agents: Trellis (BlueCircle) MCP Server →

Getting Started

  • Schedule Integration Assessment

Book a 30-minute session to confirm your modules, crops and regions, and authentication model.

  • Supergood Generates and Validates Your API

We deliver a hardened, production-ready Trellis adapter tailored to your tenant configuration and data deliveries.

  • Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as Trellis evolves.

TRELLIS (BLUECIRCLE) ON THE API REPORT CARD
Trellis (BlueCircle)DAccolent ERPDAptean FoodFAspenTechF

Potential API Endpoints

Authentication

POST/authenticate

Authenticate to a Trellis (BlueCircle) tenant using username/password, or MFA, and obtain a session token for downstream calls.

Forecasts

GET/forecasts

List yield, quality, and harvest-timing forecasts at block, appellation, and region level with crop and season filters.

Fields

GET/fields

Retrieve fields, blocks, and appellations with their crops, geography, and field-measurement history.

Fields

POST/create_observation

Submit field measurements or crop/weather observations against a field or block to refine forecasts.

Growers

GET/growers

Pull grower and supplier records with sourcing targets, deliveries, and contract context.

Supply Chain

GET/supply_insights

Retrieve supply-vs-demand insights, outlier alerts, and risk signals across production plans and deliveries.

Use Cases

Sync yield and quality forecasts into sourcing and planning systems

- Pull block- and appellation-level yield, quality, and harvest-timing forecasts into your planning warehouse - Compare predicted yields against historical averages to flag under- and over-supply early - Feed refreshed in-season forecasts to procurement and production scheduling tools

Automate harvest scheduling and field-operation decisions

- Surface harvest schedule, order, and priority recommendations to operations teams - Trigger workflows when forecasts shift due to weather, disease, or field activity - Push field measurements and crop observations back to sharpen predictions

Reconcile supply against demand and production plans

- Stream supply-vs-demand insights and outlier alerts into S&OP and demand-planning tools - Match grower deliveries against sourcing targets and production plans - Quantify cost and waste impact of supply shifts for finance and sustainability reporting

Unify grower and supplier data across regions

- Onboard grower and supplier records with fields, blocks, and contracts into a single view - Map block- and appellation-level data to your own field and sourcing hierarchy - Keep delivery and sourcing-target data in sync with downstream ERP and CRM systems

Technical Requirements

Authentication

Username/password and MFA (SMS, email, TOTP) handled in a managed session

Connectivity

Authenticated browser flows plus customer data deliveries surfaced as a unified API

Response format

Normalized JSON across forecasts, fields, blocks, growers, and supply-insight objects

Rate limits

Adaptive throttling tuned to your tenant to avoid platform-side limits

Session management

Automatic session refresh, MFA replay handling, and credential rotation

Data freshness

Near real-time pulls of in-season forecasts with optional scheduled batch syncs

Security

Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging

Webhooks

Event-style callbacks for forecast updates, outlier alerts, and delivery changes

Latency

Sub-second reads on cached forecasts and field records; multi-second writes when posting observations

Throughput

Horizontally scaled workers sized to multi-region, multi-grower data volume

Reliability

Retry, backoff, and idempotency keys for observation submissions and sourcing updates

Adaptation

Continuous monitoring of Trellis (BlueCircle) releases and tenant-specific configuration drift

Frequently asked questions

Trellis delivers forecasts and insights primarily through its SaaS dashboard and customer-specific data deliveries, without a documented self-serve developer API. Supergood builds a resilient API layer over your authenticated tenant so you can pull and push data programmatically.

Trellis applies its forecasting across food and beverage verticals including wine, coffee, barley for beer, wheat for pasta, and fresh fruit for juice. Supergood adapts to your tenant's configured crops, regions, and customer-specific models rather than forcing a generic schema.

Yes. Block-, appellation-, and region-level yield, quality, and harvest-timing forecasts are exposed through the normalized API, mapped to your own field and sourcing hierarchy.

Forecasts shift as the season progresses, so Supergood pulls fresh predictions on near real-time or scheduled cadences rather than caching stale values, and can emit callbacks when forecasts or outlier alerts change.

Trellis already ingests field measurements, deliveries, production plans, and financial data from legacy systems. Supergood normalizes the resulting forecasts and entities into consistent objects so you integrate once across your upstream sources.

Related APIs in Manufacturing & Distribution ERP

Manufacturing & Distribution ERP

Wherefour API

Wherefour is a cloud manufacturing and distribution ERP that unifies lot-level inventory, production, traceability, and compliance for food, beverage, cannabis, chemical, and other regulated manufacturers. An unofficial API lets you programmatically pull lots, inventory, orders, work orders, recipes/formulas, purchase orders, and suppliers—and push updates like new orders, production batches, and inventory adjustments back into Wherefour.

Manufacturing & Distribution ERP

AVEVA API

AVEVA is an industrial software company whose platform spans engineering, operations, and data management for energy, manufacturing, and infrastructure, anchored by the AVEVA PI System and the CONNECT industrial intelligence platform. An unofficial API lets you programmatically pull time-series tags, assets, elements, attributes, events, streams, and alarm data—and push values, configuration, and stream updates back into PI System and CONNECT data services across your industrial estate.

Manufacturing & Distribution ERP

Accolent ERP API

Accolent ERP, from ADS Solutions, is a cloud-based, browser-delivered ERP suite for wholesale distributors and light manufacturers, hosted on AWS and spanning order management, inventory, warehouse management, eCommerce, purchasing, and full GAAP accounting. An unofficial API lets you programmatically pull customers, orders, invoices, inventory, purchase orders, and general-ledger data—and push updates like new orders, invoices, and inventory adjustments back into Accolent.

Manufacturing & Distribution ERP

Aptean Food API

Aptean Food & Beverage ERP is an industry-specific cloud ERP built on Microsoft Dynamics 365 Business Central, delivering lot traceability, recipe and quality management, catch weight, and supply chain operations for food and beverage manufacturers and distributors. An unofficial API lets you programmatically pull items, lots, recipes, inventory, sales and purchase orders, and customer/vendor records—and push updates like new orders, production batches, and quality results back into Aptean Food.

Manufacturing & Distribution ERP

AspenTech API

AspenTech (Aspen Technology) is industrial asset optimization software for the process industries, spanning process engineering, manufacturing & supply chain, and asset performance management—including the Aspen InfoPlus.21 historian, aspenONE Process Explorer, and Aspen Mtell prescriptive maintenance. An unofficial API lets you programmatically pull process historian tags and time-series, assets and equipment health, Mtell anomaly/failure agents, work-order-driving alerts, and KPI/dashboard data—and push acknowledgements, asset metadata, and maintenance triggers back into AspenTech.

Manufacturing & Distribution ERP

BatchMaster API

BatchMaster is an industry-specific ERP and manufacturing platform built for formula-based, process manufacturers in food and beverage, chemicals, nutraceuticals, pharmaceuticals, and personal care. An unofficial API lets you programmatically pull formulas, batches, lots, inventory, sales and purchase orders, and quality results—and push updates like new orders, production batches, and QC results back into BatchMaster.

Ready to get a real API?