Trustwell · Schema

Recall

A food product recall or withdrawal event in the Trustwell FoodLogiQ system, capturing voluntary, mock, or regulatory recall actions.

Food IndustryFood SafetyNutritionSupply ChainFood LabelingTraceabilityComplianceFood Technology

Properties

Name Type Description
id string Unique identifier for the recall event.
title string Short title describing the recall event.
reason string Detailed reason for initiating the recall.
recallType string Type of recall action: voluntary (company-initiated), mock (drill), regulatory (FDA/USDA-mandated), or market withdrawal.
status string Current status of the recall.
recallClass string FDA recall classification. Class I is the most serious (health hazard). Class II is less serious. Class III is unlikely to cause adverse health.
productIds array Identifiers of products included in this recall.
lotNumbers array Specific lot or batch numbers covered by the recall.
affectedQuantity number Estimated quantity of product affected by the recall.
affectedUnit string Unit of measure for affected quantity (e.g., units, cases, lbs).
distributionScope string Geographic scope of product distribution affected.
supplierId string Identifier of the supplier associated with the recalled product.
regulatoryNotification boolean Whether the regulatory agency (FDA/USDA) has been notified.
publicNotification boolean Whether a public press release has been issued.
completedAt string Timestamp when the recall was completed.
createdAt string Timestamp when the recall event was initiated.
updatedAt string Timestamp when the recall record was last updated.
View JSON Schema on GitHub

JSON Schema

trustwell-recall-schema.json Raw ↑ 
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api.trustwell.com/schemas/recall",
  "title": "Recall",
  "description": "A food product recall or withdrawal event in the Trustwell FoodLogiQ system, capturing voluntary, mock, or regulatory recall actions.",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Unique identifier for the recall event."
    },
    "title": {
      "type": "string",
      "description": "Short title describing the recall event."
    },
    "reason": {
      "type": "string",
      "description": "Detailed reason for initiating the recall."
    },
    "recallType": {
      "type": "string",
      "enum": ["voluntary", "mock", "regulatory", "withdrawal"],
      "description": "Type of recall action: voluntary (company-initiated), mock (drill), regulatory (FDA/USDA-mandated), or market withdrawal."
    },
    "status": {
      "type": "string",
      "enum": ["active", "pending", "completed", "cancelled"],
      "description": "Current status of the recall."
    },
    "recallClass": {
      "type": "string",
      "enum": ["Class I", "Class II", "Class III"],
      "description": "FDA recall classification. Class I is the most serious (health hazard). Class II is less serious. Class III is unlikely to cause adverse health."
    },
    "productIds": {
      "type": "array",
      "description": "Identifiers of products included in this recall.",
      "items": {
        "type": "string"
      }
    },
    "lotNumbers": {
      "type": "array",
      "description": "Specific lot or batch numbers covered by the recall.",
      "items": {
        "type": "string"
      }
    },
    "affectedQuantity": {
      "type": "number",
      "description": "Estimated quantity of product affected by the recall."
    },
    "affectedUnit": {
      "type": "string",
      "description": "Unit of measure for affected quantity (e.g., units, cases, lbs)."
    },
    "distributionScope": {
      "type": "string",
      "enum": ["local", "regional", "national", "international"],
      "description": "Geographic scope of product distribution affected."
    },
    "supplierId": {
      "type": "string",
      "description": "Identifier of the supplier associated with the recalled product."
    },
    "regulatoryNotification": {
      "type": "boolean",
      "description": "Whether the regulatory agency (FDA/USDA) has been notified."
    },
    "publicNotification": {
      "type": "boolean",
      "description": "Whether a public press release has been issued."
    },
    "completedAt": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the recall was completed."
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the recall event was initiated."
    },
    "updatedAt": {
      "type": "string",
      "format": "date-time",
      "description": "Timestamp when the recall record was last updated."
    }
  },
  "required": ["id", "title", "reason", "recallType", "status"]
}