Trustwell's Realtime Nutritional API is a white-label, real-time nutrition calculation engine intended to power consumer-facing applications. It supports live recalculation as end users add, remove, or adjust ingredient quantities, and it can produce label data outputs for finalized recipes/products. The API is optimized for high-volume consumer traffic with sub-second response times.

Preview: https://nutritional-api-preview.trustwell.com/

Production: https://nutritional-api.trustwell.com/

Preview: https://nutritional-api-preview.trustwell.com/docs

Production: https://nutritional-api.trustwell.com/docs

All requests require an API Key provided in the header:

API Keys authenticate requests and are used for usage aggregation and billing.

Only Administrators with API Access can generate API Keys.

1. Log into the Genesis Foods application.

2. In the lower left, click the vertical ellipsis next to your Organization Name / Username.

3. Select Profile.

4. Select API Tokens along the top.

5. Click Create API Token.

6. Enter a Label (a friendly name to identify the token’s intended use).

7. Click Create Token.

8. Copy and securely store the token.

• This is the only time the full token will be shown. If it is lost or compromised you will need to delete it and create a new one.

• Preserve this token as you would other secrets/passwords.

The API is designed for sub-second response times under normal operating conditions. In consumer-facing ingredient adjustment workflows, clients should plan for frequent calls and rely on the response to drive immediate UI updates.

Default limits are:

• 10 requests per second per customer tenant

• Enforced on a rolling per-minute window

• Bursting is permitted for short periods, and a grace period is applied to accommodate brief spikes

If you anticipate sustained higher throughput (e.g., high concurrency or elevated consumer traffic), contact Trustwell to discuss contracted limits.

API Keys must not be embedded in mobile apps, web apps, or other distributed client code where they can be extracted. Instead, route requests through your own middleware/service layer that holds the API Key securely.

• Client app sends ingredient adjustments / recipe selections to your middleware.

• Middleware calls the Nutritional API using the API Key.

• Middleware returns results to the client.

This reduces the risk of credential leakage and enables additional controls (rate limiting, caching, auditing, anomaly detection).

This endpoint performs real-time nutritional recalculation for a set of food items with quantities. It is intended for interactive consumer experiences where a user adjusts ingredient amounts and expects immediate nutritional updates. The response returns a normalized nutrient list and includes ingredient and allergen statements suitable for display.

Request Body: CalculatorRequest

Request Fields:

• foodItems (array, required): Array of food items

  • foodId (string, required): Unique identifier for the food item

  • amount (object, required): Amount information

    • unitId (string, required): Unit identifier (e.g., "a7df0af5-0005-0000-7484-751e8eaf05c6" for "Each")

    • quantity (string, required): Quantity value (e.g., "1", "0.5", "1.5")

Response: CalculatorResponse

Status Code: 200 OK

Response Fields:

• nutrients (array): Array of normalized nutrient information

  • nutrientId (string): Nutrient UUID

  • nutrientName (string): Human-readable nutrient name

  • unitId (string): Unit UUID

  • unitName (string): Human-readable unit name

  • value (number): Nutrient value

• ingredientStatement (object): Ingredient statements in multiple languages

  • english (string): English ingredient statement

  • spanish (string): Spanish ingredient statement

• allergenStatement (object): Allergen statements in multiple languages

  • english (object): English allergen statements

    • statement (string): Main allergen statement

    • voluntaryStatement (string): Voluntary allergen statement

  • spanish (object): Spanish allergen statements

    • statement (string): Main allergen statement

    • voluntaryStatement (string): Voluntary allergen statement

400 BAD REQUEST: Invalid request format or missing required fields

500 INTERNAL SERVER ERROR: Server error during processing

Notes

• The API normalizes nutrient quantities into a consistent catalog (IDs, names, units) to support stable downstream rendering and analytics - negating the need to make constant calls into the metadata endpoint.

• Clients should treat this endpoint as the primary “live update” engine and call it as users change configuration (within rate limits).

This endpoint returns nutritional label data for a single recipe. It is intended for “finalized” or “summary” experiences where the consumer wants a complete nutritional profile, or where downstream systems need a label-ready nutrient set aligned to a specific regulation.

Request Body: LabelRequest

Request Fields:

• foodId (string, required): Unique identifier for the food item

• regulation (string, optional): Regulation type for label formatting. Defaults to "UnitedStates2016" if not provided.

Supported Regulation Types:

• "UnitedStates2016" (default)

• "Canada2016"

• "Mexico2020"

• "EuropeanUnion2011"

• "AustraliaNewZealand2016"

Response: LabelResponse

Status Code: 200 OK

Response Fields:

• regulation (string): The regulation type used for label formatting

• servingSize (string, nullable): Serving size description (e.g., "1 cup (240ml)")

• nutrients (array): Array of normalized label nutrients

  • nutrientId (string): Nutrient UUID

  • nutrientName (string): Human-readable nutrient name from constants

  • unitId (string, nullable): Unit UUID

  • unitName (string, nullable): Human-readable unit name

  • name (string): Nutrient name as it appears on the label

  • quantity (string, nullable): Formatted quantity string (e.g., "231", "2.8g")

  • amount (number, nullable): Numeric amount value

  • percentDv (number, nullable): Percent daily value

  • isSignificant (boolean): Whether the nutrient is significant for labeling

• caloriesPerContainer (object, nullable): Calories per container information (for Mexico2020 regulation). Has the same structure as a nutrient object.

United States 2016 (default):

Canada 2016:

Mexico 2020:

European Union 2011:

Australia/New Zealand 2016:

Using default regulation (UnitedStates2016):

400 BAD REQUEST: Invalid request format or missing required fields

500 INTERNAL SERVER ERROR: Server error during processing

Notes

• The response includes label-specific fields (e.g., percent DV, significance flags) to support rendering compliant label detail .

• For certain regulations (e.g., Mexico2020), caloriesPerContainer may be populated where required by the regulation format.

These endpoints provide lookup catalogs used for reference and mapping (e.g., building UI selectors, validating IDs, or aligning internal data models). They are not intended for high-frequency consumer calls and should typically be cached on the client’s middleware layer. These are the values that exist in Genesis Foods to ensure alignment of IDs and values.

Returns a nutrient catalog mapping (commonly “name → id”), representing the authoritative nutrient identifiers used by the API. This is useful for validating nutrient IDs and building consistent storage/mapping in downstream systems.

Returns a unit catalog mapping (commonly “name → id”) for the measurement units used in requests and responses. This allows clients to align quantity inputs and to display nutrient values with consistent unit labeling.

Returns allergen catalogs by region (e.g., Mexico, Canada, Australia). This can be used to align allergen display logic, voluntary statements, or region-specific allergen expectations.

Returns the supported language catalog. This is primarily useful for understanding what language outputs are available and for building UI expectations around multi-language responses.

Returns aggregated request counts for the authenticated API key. This is intended to support tiered billing and operational monitoring of consumer traffic driven by the calling application. Only usage (both successful and failed) associated with the provided API key is returned.

Query parameters (optional)

• start_date: start of aggregation window (ISO 8601 or YYYY-MM-DD)

• end_date: end of aggregation window (ISO 8601 or YYYY-MM-DD)

Notes

• If dates are omitted, the response defaults to a recent window (the last 30 days).

• The response is designed to be easily imported into downstream reporting/billing systems.

Returns API and system information for the current environment. This endpoint is intended for operational visibility and integration validation (e.g., confirming environment, version, and service-reported status). It also includes information surfaced by /api/health.

Returns a health status based on backing-system connectivity checks. The service is considered healthy only if required dependencies are healthy. This endpoint is typically used by external uptime monitors, and deployment validation checks.

• foodItems (array of FoodItem, required)

• foodId (string, required)

• amount (Amount, required)

• unitId (string, required)

• quantity (string, required)

• nutrients (array of Nutrient, required)

• ingredientStatement (IngredientStatement, required)

• allergenStatement (AllergenStatement, required)

• nutrientId (string, required)

• nutrientName (string, required)

• unitId (string, required)

• unitName (string, required)

• value (number, required)

• english (string, required)

• spanish (string, required)

• english (AllergenStatements, required)

• spanish (AllergenStatements, required)

• statement (string, required)

• voluntaryStatement (string, required)

• foodId (string, required)

• regulation (string, optional; default UnitedStates2016)

• regulation (string, required)

• servingSize (string/null)

• nutrients (array of LabelNutrient, required)

• caloriesPerContainer (LabelNutrient/null)

• nutrientId (string, required)

• nutrientName (string, required)

• unitId (string/null)

• unitName (string/null)

• name (string, required)

• quantity (string/null)

• amount (number/null)

• percentDv (number/null)

• isSignificant (boolean; default false)