How it works
A single greenLightWorkflow operation contains three mutations:
partyCreateWorkflow— Creates origin and destination partiesitemCreateWorkflow— Creates the items being shippedgreenLightWorkflow— Runs the selected compliance checks against the parties and items created in the same operation
The GreenLightWorkflowInput accepts six boolean toggles to enable or disable individual checks. All default to true. Omit any check you don't need—the rest run independently.
Checks
HS code coherence (hsCodeCoherence) — Validates whether the declared HS code is coherent with the item description using AI classification. Returns a confidenceScore (higher = more confident in the code = less risk) and hsCodeProvidedValidation showing coherence at the chapter, heading, and subheading level.
Country of origin validation (countryOfOriginValidation) — Verifies the declared manufacturing origin against AI-predicted origin via Zonos Country of Origin. Returns probabilityOfMisrepresentation—higher values indicate the declared origin is more likely inaccurate.
Value validation (valueValidation) — Compares declared customs values against AI-estimated market values via Customs Value. Returns probabilityOfUnderValuation to catch undervaluation.
Restriction check (restrictionCheck) — Screens items against import, export, and carrier-specific restriction lists via Restrict. Returns restrictions with a category, summary, confidence, and confidenceScore.
Regulation check (regulationCheck) — Identifies applicable trade regulations and required certifications for items. Returns matched regulations with a certificateType, summary, and confidenceScore.
Denied party screening (deniedPartyScreening) — Screens shipment parties against international denied party lists via Screen. Returns an action (NO_MATCHES, REVIEW, or BLOCK) and match details including name, location, and overall scores.
Interpreting results
The response contains two summary objects for quick, aggregate assessment:
itemRiskSummary— Rolls up risk across all items. IncludesmaxProbabilityfor undervaluation,maxMisrepresentationProbabilityfor country of origin,maxMiscoherenceProbabilityandworstOutcomefor HS code coherence, and aggregate counts and worst-case scores for restrictions and regulations.partyScreeningSummary— Rolls up party screening results. Returns the overallactionandmaxDeniedPartyMatchScoreacross all screened parties.
itemResults and partyScreenings contain per-item and per-party details when you need to identify exactly which items or parties triggered a flag.
Probability scores are returned as decimals between 0.0 and 1.0. There are no universal LOW/MED/HIGH thresholds built into the API—calibrate cutoffs against your own traffic mix and risk tolerance.
Use cases
Customs brokers: Run Greenlight on every shipment before submission to identify misclassified items, incorrect origin declarations, or undervalued goods. Catch compliance issues before they result in delays, penalties, or audits.
Package forwarders: Assess each incoming package for export readiness without requiring specialized trade knowledge from intake staff. Greenlight surfaces exactly which items need attention and why, enabling faster processing with fewer errors.
Carriers and logistics providers: Integrate Greenlight into shipment acceptance workflows to screen packages at the point of pickup or intake. Reject or flag non-compliant shipments before they enter your network, reducing the risk of customs holds and associated costs.
Customs agencies: Use Greenlight to prioritize inspections by focusing on shipments with high misrepresentation risk scores. Low-risk shipments can be fast-tracked, improving throughput while maintaining enforcement accuracy.
API guide
The example below runs all six checks. Set any toggle to false in GreenLightWorkflowInput to skip that check.
mutation GreenLightWorkflow($partyInput: [PartyCreateWorkflowInput!]!$itemInput: [ItemCreateWorkflowInput!]!$greenLightInput: GreenLightWorkflowInput!) { partyCreateWorkflow(input: $partyInput) { id type location { countryCode } } itemCreateWorkflow(input: $itemInput) { id name hsCode countryOfOrigin } greenLightWorkflow(input: $greenLightInput) { id organizationId createdAt createdBy itemRiskSummary { itemCount underValuation { maxProbability } countryOfOriginMisrepresentation { maxMisrepresentationProbability } hsCodeCoherence { maxMiscoherenceProbability worstOutcome } restriction { matchedCount affectedItemCount worstCategory worstConfidence maxConfidenceScore } regulation { matchedCount affectedItemCount maxConfidenceScore } } partyScreeningSummary { partyCount action maxDeniedPartyMatchScore } itemResults { item { id name hsCode countryOfOrigin amount currencyCode } classification { id customsDescription confidenceScore hsCodeProvidedValidationScore hsCodeProvidedValidation { code } } valueValidation { id probabilityOfUnderValuation value currency } countryOfOriginValidation { id probabilityOfMisrepresentation countryOfOrigin } appliedRestrictions { id itemHsCode restrictions { id category confidence confidenceScore summary url imposingCountryCode measureDirection } } appliedRegulations { id itemHtsCode certificateType regulations { id referenceId summary confidenceScore } } } partyScreenings { id action party { id type } matches { scores { overall name location } name companyName countryCode deniedParty { id name companyName countryCode source sourceUrls } } } }}Getting started
Zonos Greenlight requires a subscription. To learn more about access, pricing, and API integration, contact sales.
Zonos Greenlight
Verify that shipments are compliant and ready for export.
Zonos Greenlight provides a comprehensive export readiness assessment for international shipments. It runs AI-powered checks across six areas: HS code coherence, country of origin validation, customs value verification, product restrictions, trade regulations, and denied party screening.
The
greenLightWorkflowmutation bundles party creation, item creation, and all compliance checks into a single GraphQL operation. You control which checks run via theGreenLightWorkflowInput—all checks are enabled by default. The response includes both high-level summaries for quick decisioning and per-item and per-party details for deeper review.