Skip to main content

zentria-flow

Free US import duty lookups from Python and the command line: every tariff layer for an HTS code and a country of origin (MFN duty, Section 301, the forced-labor Section 301 tariff, Section 232, Section 338 on Canada), the total, and the tariff changes already dated for that line.

No API key, no account, no dependencies. Answers come from the Zentria Flow tariff engine (HTSUS 2026 Revision 23 plus the chapter 99 programs).

pip install zentria-flow

Command line

$ zentria-flow check 9405.31.00 CN
HTS 9405.31.00 from CN  (entry date 2026-11-20)
  MFN duty                                8%
  Section 301                            25%  (List 3)
  Forced-labor Section 301 tariff      12.5%  (applies)
  Section 232                             0%
  Section 338 (Canada)                    0%
  Total US duty                        45.5%

$ zentria-flow check 9403.40.9060 VN --as-of 2027-01-02     # kitchen cabinets after 1 Jan
  Section 232                            50%
  Total US duty                          50%

$ zentria-flow compare 9503.00.00 CN VN                     # toys
  CN     12.5%
  VN     12.5%

$ zentria-flow search christmas lights
$ zentria-flow calendar --origin VN                          # dated changes that hit Vietnam
$ zentria-flow price products.csv > priced.csv               # columns: hts, origin, value

Rates above were checked on 20 Nov 2026. They change: run the command for today's answer.

Python

from zentriaflow import Client

c = Client()
r = c.tariff_check("6109.10.00", "CN")      # cotton T-shirt from China
r.total_rate                                 # 36.5
[(l["label"], l["rate"]) for l in r.layers]  # each tariff layer
r.duty(12_000)                               # 4380.0 (ad valorem part)
r.scheduled_changes                          # dated changes already on file

c.compare_origins("9405.31.00", ["CN", "VN", "KH", "MX"])   # lowest total first
c.hts_search("cotton t-shirt")
c.tariff_calendar(origin="VN")

rows = [{"hts": "9403.40.9060", "origin": "VN", "value": 40000}]
c.price_rows(rows)    # adds total_rate, duty and next_change to each row

as_of="YYYY-MM-DD" prices an entry date up to 12 months ahead. US duty is set on the day goods are entered, so a December order entered in January pays January's rate.

Limits

The free API allows about 60 tariff checks an hour per IP address (searches and calendar reads have their own, larger allowance). Client(wait_on_limit=True) waits and retries once when the limit is hit. For higher volume, a key-based API with plans is at zentriaflow.com/developers.

Other ways to use the same engine

Disclaimer

Planning estimates, not customs rulings. Anti-dumping and countervailing duties are company-specific and are not in any total. Confirm classification and rates with a licensed customs broker before entry.

MIT licensed. Zentria Flow, Inc.

Metadata

Release files for zentria-flow 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for zentria-flow 0.1.0
File Size Uploaded Provenance Actions
zentria_flow-0.1.0.tar.gz 11.1 kB With provenance Details for zentria_flow-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for zentria-flow 0.1.0
File Interpreter ABI Platform Actions
zentria_flow-0.1.0-py3-none-any.whl Python 3 none any Details for zentria_flow-0.1.0-py3-none-any.whl

Total release size: 21.8 kB

Release files / zentria_flow-0.1.0.tar.gz

Download URL zentria_flow-0.1.0.tar.gz
Size 11.1 kB
Tags Source
SHA-256 checksum
How to use checksums
b905b28a35a8856f34776952b28d031f875cc9d52349d71fca93beee682a8dfa
BLAKE2b-256 checksum
How to use checksums
82c9019551a6d1c28356b5bdc939e930d99c042f70647655e3d2b803aba5341b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Release files / zentria_flow-0.1.0-py3-none-any.whl

Download URL zentria_flow-0.1.0-py3-none-any.whl
Size 10.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
79b3f460aca24ff269992d61f4d38390233325de54144a1bac186979e3468c33
BLAKE2b-256 checksum
How to use checksums
4f5448921149f5f6af314205755ef238492be0118b5c0e4f35ee6385ad8727f8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

Security for zentria-flow 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for zentria_flow-0.1.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 20, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page