# Tariffs & Trade Reference API > Look up US HTS duty rates, UK Global Tariff third-country duty, US Schedule B export codes, and FAA US airports from vendored official snapshots, plus ISO 6346 container validation and CBP bond explanations from caller input. Each paid operation uses a fixed USDC price on Base with the x402 exact scheme. Unpaid GET, HEAD, and POST return 402 payment terms (POST validates the body only after payment terms are satisfied). A request that carries payment-signature is not yet charged: settlement happens only after a successful (2xx) result. HTTP 4xx/5xx are not charged. Coverage bodies with status complete, partial, or failed all return HTTP 200 and are charged at the full listed price. Settled 2xx responses include a payment-response header; 4xx/5xx do not. Follow https://www.brainiac.software/agent-instructions.txt for install, payment pins, idempotency, and billing rules. - Product: https://www.brainiac.software/api/trade-tariff - Docs: https://www.brainiac.software/api/trade-tariff/docs - OpenAPI: https://www.brainiac.software/api/trade-tariff/openapi.json - Contact: support@brainiac.software (https://www.brainiac.software/contact) ## Operations ### POST /api/v1/trade-tariff/container-iso6346-validate $0.01 USDC. Validate freight container owner code, category identifier, serial, and ISO 6346 check digit. Does not confirm registration. Inputs: containerNumber Docs: https://www.brainiac.software/api/trade-tariff/docs#trade-tariff-container-iso6346-validate Example request: ```json { "containerNumber": "CSQU3054383" } ``` Example response: ```json { "retrievedAt": "2026-11-14T20:00:00.000Z", "containerNumber": "CSQU3054383", "formatOk": true, "ownerCode": "CSQ", "categoryIdentifier": "U", "serialNumber": "305438", "expectedCheckDigit": 3, "observedCheckDigit": 3, "checksumOk": true, "valid": true, "sources": [ { "source": "ISO 6346 freight container coding / check digit", "url": "https://www.iso.org/standard/83515.html", "retrievedAt": "2026-11-14T20:00:00.000Z", "status": "ok" } ], "limitations": [ "Validates owner code, category identifier, serial, and check digit only." ] } ``` ### POST /api/v1/trade-tariff/customs-bond-type-explain $0.02 USDC. Return a short structured explanation of common CBP customs bond forms and activity codes from public CBP bond concepts. Inputs: bondType? Docs: https://www.brainiac.software/api/trade-tariff/docs#trade-tariff-customs-bond-type-explain Example request: ```json { "bondType": "continuous" } ``` Example response: ```json { "retrievedAt": "2026-11-14T20:00:00.000Z", "bondType": "continuous", "title": "Continuous bond (CBP)", "summary": "A continuous customs bond covers entries over a period (commonly one year) for an importer of record, instead of postin…", "typicalUses": [ "Frequent importers", "Multiple ports of entry over the bond term" ], "sources": [ { "source": "US CBP public customs bond overview (activity codes)", "url": "https://www.cbp.gov/trade/programs-administration/bonds", "retrievedAt": "2026-11-14T20:00:00.000Z", "status": "ok" } ], "limitations": [ "This is a short structured explanation from public CBP bond concepts, not a bond application." ] } ``` ### POST /api/v1/trade-tariff/us-hts-duty-rate-lookup $0.02 USDC. Return the published HTSUS General, Special and Column 2 rate columns, units and Chapter 99 cross-references for an HTS code from the vendored USITC release. Not a classification or additional-duty calculation. Inputs: hts, program? Docs: https://www.brainiac.software/api/trade-tariff/docs#trade-tariff-us-hts-duty-rate-lookup Example request: ```json { "hts": "6109.10.0004", "program": "AU" } ``` Example response: ```json { "hts": "6109.10.00.04", "found": true, "description": "T-shirts, all white, short hemmed sleeves, hemmed bottom, crew or round neckline, or V-neck with a mitered seam at the …", "path": [ "T-shirts, singlets, tank tops and similar garments, knitted or crocheted:", "Of cotton", "…" ], "rateLine": "6109.10.00", "general": "16.5%", "special": { "text": "Free (AU,BH,CL,CO,IL,JO,KR,MA,OM,P,PA,PE,S,SG)", "rate": "Free", "programs": [ "AU", "BH", "…" ] }, "column2": "90%", "units": [ "doz.", "kg" ], "chapter99References": [], "footnotes": [], "children": [], "programEligible": true, "release": { "name": "2026HTSRev23", "startDate": "2026-11-10" }, "sources": [ { "source": "USITC Harmonized Tariff Schedule of the United States, 2026 HTS Revision 23", "url": "https://hts.usitc.gov/reststop/exportList?from=0101&to=9999&format=JSON&styles=false", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Published HTSUS rate columns only. This is not a classification, a landed-cost estimate, or a calculation of Section 23…", "Chapter 99 measures (including Section 301 lists in U.S. note 20 to subchapter III) must be checked separately; chapter…", "…" ] } ``` ### POST /api/v1/trade-tariff/uk-global-tariff-lookup $0.02 USDC. Return the UK Global Tariff third-country (measure type 103) duty for a UK commodity code from a vendored DBT dataset subset. Preferential rates are not included. Inputs: commodityCode, date? Docs: https://www.brainiac.software/api/trade-tariff/docs#trade-tariff-uk-global-tariff-lookup Example request: ```json { "commodityCode": "6109100010" } ``` Example response: ```json { "commodityCode": "6109100010", "found": true, "date": "2026-11-14", "measures": [ { "dutyExpression": "12%", "geographicalArea": { "id": "1011", "description": "ERGA OMNES" }, "excludedAreas": [], "additionalCode": null, "quotaOrderNumber": null, "startDate": "2021-01-01", "endDate": null, "regulation": "S.I. 2020/1430" }, { "dutyExpression": "0%", "geographicalArea": { "id": "1080", "description": "Channel Islands" }, "excludedAreas": [], "additionalCode": null, "quotaOrderNumber": null, "startDate": "2021-01-01", "endDate": null, "regulation": "S.I. 2020/1430" } ], "datasetVersion": "v4.0.1656", "sources": [ { "source": "DBT Tariffs to trade with the UK from 1 January 2021 (measures-on-declarable-commodities, type 103), Open Government Li…", "url": "https://data.api.trade.gov.uk/v1/datasets/uk-tariff-2021-01-01/versions/v4.0.1656/tables/measures-on-declarable-commodi…", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Third-country duty (measure type 103) only; preferential trade-agreement rates, quotas, anti-dumping and other measure …", "Answered from the vendored DBT snapshot v4.0.1656 (in-force measures on 2026-11-14); later amendments are not known.", "…" ] } ``` ### POST /api/v1/trade-tariff/us-schedule-b-lookup $0.02 USDC. Look up a 10-digit US Schedule B export code or search Schedule B descriptions in the vendored Census concordance. Not an AES filing. Inputs: code?, query?, limit? Docs: https://www.brainiac.software/api/trade-tariff/docs#trade-tariff-us-schedule-b-lookup Example request: ```json { "code": "8471300100" } ``` Example response: ```json { "results": [ { "code": "8471300100", "shortDescription": "PORT DGTL ADP MACH,< 10 KG,AT LEAST CPU,KBRD,DSPLY", "longDescription": "PORTABLE DIGTL AUTOMATIC DATA PROCESSING MACHINES,WEIGHT NOT MORE THAN 10 KG,CONSISTING OF AT LEAST A CENTRAL PROCESSIN…", "units": [ "NO" ], "sitc": "75220", "endUse": "21300", "usda": false, "naics": "334111", "hitech": "04" } ], "sources": [ { "source": "US Census Bureau Schedule B export concordance (econcord.txt, 2026)", "url": "https://www.census.gov/foreign-trade/schedules/b/2026/sbsdf.zip", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "Lookup only; not an AES filing or a classification ruling.", "usda is true when the Census USDA flag marks the code as an agricultural product.", "…" ] } ``` ### POST /api/v1/trade-tariff/us-airport-lookup $0.01 USDC. Look up a US landing facility by FAA location identifier, ICAO id or name from the vendored FAA NASR 28-day APT_BASE data. Inputs: faaId?, icao?, name?, state?, limit? Docs: https://www.brainiac.software/api/trade-tariff/docs#trade-tariff-us-airport-lookup Example request: ```json { "icao": "KJFK" } ``` Example response: ```json { "results": [ { "siteNo": "15793.", "faaId": "JFK", "icao": "KJFK", "name": "JOHN F KENNEDY INTL", "city": "NEW YORK", "state": "NY", "siteType": "AIRPORT", "status": "OPERATIONAL", "ownership": "PUBLICLY OWNED", "facilityUse": "OPEN TO THE PUBLIC", "latitude": 40.63992805, "longitude": -73.77869222, "elevationFt": 13, "far139": "I E" } ], "cycle": "2026-10-29", "sources": [ { "source": "FAA NASR 28-day subscription, APT_BASE.csv", "url": "https://nfdc.faa.gov/webContent/28DaySub/extra/29_Oct_2026_APT_CSV.zip", "retrievedAt": "2026-11-14", "status": "ok" } ], "limitations": [ "US landing facilities in FAA NASR only; non-US airports return no results.", "ICAO ids are present for a subset of facilities and are never inferred; IATA codes are not in the file and faaId is not…", "…" ] } ```