What is Zonos Clarify?

Zonos Clarify automates partner government agency (PGA) compliance for cross-border shipments. It identifies which agency requirements apply to each item based on its HS code and route, presents the agency's compliance questionnaire, pre-fills answers from your item data using AI, and attaches the finalized, compliant answers to the item so they flow into customs filing.

Which government agencies does Zonos Clarify support?

Clarify supports U.S. partner government agency (PGA) programs such as the Food and Drug Administration (FDA), USDA Agricultural Marketing Service (AMS), Consumer Product Safety Commission (CPSC), and Fish and Wildlife Service (FWS), as well as other program types including free trade agreements and tariff measures.

How do I integrate Zonos Clarify?

Clarify is available through the Zonos GraphQL API. Use the complianceRequirements query to discover which programs apply to an item, complianceQuestionnaireInfer to infer and pre-fill answers, and the questionnaire session mutations to review, answer, and finalize the questionnaires. Finalized answers are materialized onto the item for customs filing.

HomeFor logistics providers Zonos Clarify

Zonos Clarify

Automate partner government agency (PGA) compliance — find which agency requirements apply to each item, answer the questionnaires with AI prefill, and attach compliant answers for customs filing.

Many cross-border shipments are subject to partner government agency (PGA) requirements in addition to customs duties and taxes. Before goods can clear the border, the importer often has to answer agency-specific questions per item — for example, the FDA's questions for food and cosmetics, or the CPSC's certification for children's products. Getting these answers wrong (or missing them) holds shipments at the border.

Zonos Clarify turns that manual, error-prone process into a structured, automatable flow:

Discover which compliance programs apply to an item from its HS code and route.
Infer and prefill answers from your existing item data using Zonos AI.
Review and answer only the questions that remain, with branching handled for you.
Finalize so the answers are attached to the item for customs filing.

How Clarify works

A typical end-to-end flow uses the Zonos GraphQL API in four steps:

Discover requirements. Query complianceRequirements with an item's HS code and ship-to country to see which compliance programs are triggered, and read each program's questions.
Infer and prefill. Call complianceQuestionnaireInfer with your items. Clarify opens a questionnaire session and pre-answers questions from your item data — each pre-filled answer carries a confidence score.
Review and answer. Confirm or correct the pre-filled answers with questionnaireAnswersSubmit. The questionnaire branches automatically, so the shipper only sees the questions that actually apply.
Finalize. Accept the answers with questionnaireSessionAttest (or submit a complete set directly). Clarify records an immutable response and attaches the answers to the item for customs filing.

See Complete a questionnaire for the full walkthrough, and How it works for branching, provenance, and dynamic options.

Key concepts

Concept↕	What it means↕
Compliance program	A regulatory program (e.g. an FDA prior-notice program) identified by a stable `code`. Each program owns a questionnaire.
Question	A prompt with an `answerType` of `BOOLEAN`, `SINGLE_SELECT`, `MULTI_SELECT`, `TEXT`, `NUMBER`, or `DATE`.
Display condition	Branching logic that shows or hides a question based on earlier answers, so shippers never see irrelevant questions.
Inference & provenance	Clarify pre-answers questions from your item data. Each answer records where it came from — `INFERRED`, `MANUAL`, or `SUPPLIED` — and inferred answers carry a `confidence` score.
Session vs. response	A session is the in-progress questionnaire. A response is the finalized, immutable record of the answers.
Attestation	Accepting the pre-filled answers as-is to finalize without re-typing them.
Target	What the answers describe: a reusable `CATALOG_ITEM` (answer once, reuse) or a per-shipment `ITEM`.
Intended use	The declared import intent (`CONSUMER`, `COMMERCIAL`, `PERSONAL`, `RESEARCH`) that guides inference.

Supported programs

Clarify models compliance as programs, each with a programType:

PGA - U.S. partner government agency programs, including the FDA, EPA, USDA (AMS and APHIS, including the Lacey Act), CPSC, and FWS.
FTA - Free trade agreement eligibility.
TARIFF_MEASURE - Questionnaires tied to specific tariff measures.
OTHER - Anything that doesn't fit the categories above.

New programs are added over time. Use complianceRequirements to see exactly which apply to a given item and route.

Use cases

FDA-regulated goods

Answer FDA questions for food, cosmetics, supplements, and devices before import.

CPSC children's products

Attach the required attestation per item ahead of CPSC eFiling.

USDA AMS commodities

Capture organic and agricultural-marketing answers for covered goods.

FWS wildlife products

Collect Fish and Wildlife Service declarations for wildlife-derived items.

Next steps

Check compliance requirements - discover applicable programs and read questionnaire structures.
Complete a questionnaire - infer, answer, attest, and finalize via GraphQL.
How it works - branching, provenance, dynamic options, and intended use.
New to the Zonos API? Start with OAuth and API errors.

Book a demo