DOCS
HomeFor logistics providers Greenlight

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 greenLightWorkflow mutation bundles party creation, item creation, and all compliance checks into a single GraphQL operation. You control which checks run via the GreenLightWorkflowInput—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.

How it works 

A single greenLightWorkflow operation contains three mutations:

  1. partyCreateWorkflow — Creates origin and destination parties
  2. itemCreateWorkflow — Creates the items being shipped
  3. greenLightWorkflow — 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. Includes maxProbability for undervaluation, maxMisrepresentationProbability for country of origin, maxMiscoherenceProbability and worstOutcome for HS code coherence, and aggregate counts and worst-case scores for restrictions and regulations.
  • partyScreeningSummary — Rolls up party screening results. Returns the overall action and maxDeniedPartyMatchScore across 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.

1mutation GreenLightWorkflow(
2$partyInput: [PartyCreateWorkflowInput!]!
3$itemInput: [ItemCreateWorkflowInput!]!
4$greenLightInput: GreenLightWorkflowInput!
5) {
6 partyCreateWorkflow(input: $partyInput) {
7 id
8 type
9 location {
10 countryCode
11 }
12 }
13 itemCreateWorkflow(input: $itemInput) {
14 id
15 name
16 hsCode
17 countryOfOrigin
18 }
19 greenLightWorkflow(input: $greenLightInput) {
20 id
21 organizationId
22 createdAt
23 createdBy
24 itemRiskSummary {
25 itemCount
26 underValuation {
27 maxProbability
28 }
29 countryOfOriginMisrepresentation {
30 maxMisrepresentationProbability
31 }
32 hsCodeCoherence {
33 maxMiscoherenceProbability
34 worstOutcome
35 }
36 restriction {
37 matchedCount
38 affectedItemCount
39 worstCategory
40 worstConfidence
41 maxConfidenceScore
42 }
43 regulation {
44 matchedCount
45 affectedItemCount
46 maxConfidenceScore
47 }
48 }
49 partyScreeningSummary {
50 partyCount
51 action
52 maxDeniedPartyMatchScore
53 }
54 itemResults {
55 item {
56 id
57 name
58 hsCode
59 countryOfOrigin
60 amount
61 currencyCode
62 }
63 classification {
64 id
65 customsDescription
66 confidenceScore
67 hsCodeProvidedValidationScore
68 hsCodeProvidedValidation {
69 code
70 }
71 }
72 valueValidation {
73 id
74 probabilityOfUnderValuation
75 value
76 currency
77 }
78 countryOfOriginValidation {
79 id
80 probabilityOfMisrepresentation
81 countryOfOrigin
82 }
83 appliedRestrictions {
84 id
85 itemHsCode
86 restrictions {
87 id
88 category
89 confidence
90 confidenceScore
91 summary
92 url
93 imposingCountryCode
94 measureDirection
95 }
96 }
97 appliedRegulations {
98 id
99 itemHtsCode
100 certificateType
101 regulations {
102 id
103 referenceId
104 summary
105 confidenceScore
106 }
107 }
108 }
109 partyScreenings {
110 id
111 action
112 party {
113 id
114 type
115 }
116 matches {
117 scores {
118 overall
119 name
120 location
121 }
122 name
123 companyName
124 countryCode
125 deniedParty {
126 id
127 name
128 companyName
129 countryCode
130 source
131 sourceUrls
132 }
133 }
134 }
135 }
136}

Getting started 

Zonos Greenlight requires a subscription. To learn more about access, pricing, and API integration, contact sales.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
INPUTS

GreenLightWorkflowInput ItemCreateWorkflowInput PartyCreateWorkflowInput

MUTATIONS

greenLightWorkflow itemCreateWorkflow partyCreateWorkflow

Was this page helpful?

Get support·Legal docs·© 2026 Zonos
On this page:
  • Zonos Greenlight
  • How it works
  • Use cases
  • API guide
  • Getting started