{"openapi":"3.1.0","info":{"title":"US Tariff Change Watch API","version":"0.1.0","description":"US Tariff Change Watch tells an importer what changed in US tariff paperwork since last week. It reads two public US government services, both keyless: the online Harmonized Tariff Schedule of the U.S. International Trade Commission (hts.usitc.gov) and the Federal Register API of the Office of the Federal Register. hts_release_changed compares the current HTS release name with the one you saw...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://us-tariff-watch.connectorbay.com/mcp.\n\nDisclaimer: General information only, not customs, legal or tax advice. US Tariff Change Watch is an independent tool: it is not affiliated with, endorsed by or operated by the U.S. International Trade Commission, U.S. Customs and Border Protection, the Office of the U.S. Trade Representative, the Office of the Federal Register or any other government body. A changed schedule line or a Federal Register notice is reported as published; it does not say what duty applies to an import. Tariff classification and the duties owed are decided by CBP, and duty programs change often. Check the cited official source and confirm with a licensed customs broker or qualified professional before you rely on a result.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/us-tariff-watch/docs"},"termsOfService":"https://connectorbay.com/us-tariff-watch/terms"},"servers":[{"url":"https://us-tariff-watch.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/us-tariff-watch/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/hts_release_changed":{"post":{"operationId":"hts_release_changed","summary":"Current Harmonized Tariff Schedule release name from the online HTS, and whether it differs from the release you last sa","description":"Current Harmonized Tariff Schedule release name from the online HTS, and whether it differs from the release you last saw. Says a new revision exists, not which lines changed (use watch_headings for that). Use for \"Has the HTS moved past 2026HTSRev19?\" or \"Which HTS revision is current?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"last_seen":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Release name you saw last time, for example 2026HTSRev19 (2026 HTS Revision 19 and Revision 19 (2026) are accepted too). Leave empty on the first run to get the name to store","title":"Last Seen"}},"title":"hts_release_changedArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/fr_tariff_documents_since":{"post":{"operationId":"fr_tariff_documents_since","summary":"Federal Register rules, proposed rules and notices about tariffs from USTR, CBP and BIS (or agencies you choose) since a","description":"Federal Register rules, proposed rules and notices about tariffs from USTR, CBP and BIS (or agencies you choose) since a date, newest first, with a flag on any whose title or abstract names one of your HTS numbers. Keyword search is noisy and cannot look up HTS numbers. Use for \"Which tariff notices did USTR, CBP and BIS publish since 22 September?\" or \"Does any new notice name HTS 8516.71.00?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"since":{"description":"First publication date, YYYY-MM-DD","title":"Since","type":"string"},"until":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Last publication date, YYYY-MM-DD (default: today, UTC)","title":"Until"},"terms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Search words, up to 3, one Federal Register search each (default: tariff). Add words such as duties or Section 232 to widen","title":"Terms"},"agencies":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"USTR, CBP, BIS, ITA, ITC, Commerce or all (default: USTR, CBP, BIS). Add ITA and ITC to include antidumping and countervailing duty notices; all is very noisy","title":"Agencies"},"types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Document types: rule, proposed_rule, notice, presidential (default: rule, proposed_rule, notice)","title":"Types"},"headings":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"HTS numbers with 4, 6, 8 or 10 digits, up to 10, for example 8516.71.00 or 8516.71. A document is flagged when its title, abstract or dates text names one of them (annexes and full text are not read)","title":"Headings"},"limit":{"default":30,"description":"Maximum documents to return per search word, 1 to 50","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"required":["since"],"title":"fr_tariff_documents_sinceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/watch_headings":{"post":{"operationId":"watch_headings","summary":"Read the schedule lines the online HTS returns for your HTS numbers (their own lines and Chapter 99 lines that name them","description":"Read the schedule lines the online HTS returns for your HTS numbers (their own lines and Chapter 99 lines that name them) and diff them against the snapshot from your last run: lines added, removed or changed, with before and after general and column 2 rate text. Reports that something changed, not what duty applies. Use for \"What changed for HTS 8516.71.00 and 7210.30.00 since last week?\" or \"Did a new Chapter 99 line appear for my HTS number?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"headings":{"description":"HTS numbers with 4, 6, 8 or 10 digits, up to 10, for example 8516.71.00 or 8516.71","items":{"type":"string"},"maxItems":10,"minItems":1,"title":"Headings","type":"array"},"previous":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"string"},{"type":"null"}],"default":null,"description":"The next_snapshot object returned by your last run, passed back unchanged. Leave empty for a first baseline","title":"Previous"}},"required":["headings"],"title":"watch_headingsArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/presidential_actions_index":{"post":{"operationId":"presidential_actions_index","summary":"Presidential proclamations, executive orders and other presidential documents whose titles mention trade words (tariff, ","description":"Presidential proclamations, executive orders and other presidential documents whose titles mention trade words (tariff, duties, imports, trade, customs and similar), newest first, with signing and publication dates. Built from Federal Register presidential documents, not from the USTR web page. Use for \"Which presidential trade actions were published since 1 September?\" or \"Any new proclamation on tariffs this month?\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"since":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First publication date, YYYY-MM-DD (default: 60 days before until)","title":"Since"},"until":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Last publication date, YYYY-MM-DD (default: today, UTC)","title":"Until"},"match":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Words to look for in titles, up to 5 (default: a built-in list of trade words such as tariff, duties, imports, trade, customs, quota)","title":"Match"},"limit":{"default":25,"description":"Maximum matching documents to return, 1 to 100","maximum":100,"minimum":1,"title":"Limit","type":"integer"}},"title":"presidential_actions_indexArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/weekly_tariff_brief":{"post":{"operationId":"weekly_tariff_brief","summary":"One weekly tariff digest: did the HTS release change, what changed on your watched HTS numbers since the last snapshot, ","description":"One weekly tariff digest: did the HTS release change, what changed on your watched HTS numbers since the last snapshot, which new Federal Register tariff notices came out (flagged when they name your numbers) and which presidential trade documents were published. Returns next_state to pass back next week. Nothing is stored. Use for \"Give me this week's tariff brief for HTS 8516.71.00 and 7210.30.00.\" or \"Run my weekly tariff check.\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"last_seen_release":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Release name from last week's next_state, for example 2026HTSRev19","title":"Last Seen Release"},"headings":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"HTS numbers with 4, 6, 8 or 10 digits, up to 10, for example 8516.71.00 or 8516.71","title":"Headings"},"previous":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"string"},{"type":"null"}],"default":null,"description":"The next_state.snapshot object from last week's brief, passed back unchanged. Leave empty for a first baseline","title":"Previous"},"since":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"First publication date for notices and presidential documents, YYYY-MM-DD (default: 6 days before until)","title":"Since"},"until":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Last publication date, YYYY-MM-DD (default: today, UTC)","title":"Until"},"terms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"Search words for tariff notices, up to 3 (default: tariff)","title":"Terms"},"agencies":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"default":null,"description":"USTR, CBP, BIS, ITA, ITC, Commerce or all (default: USTR, CBP, BIS)","title":"Agencies"},"limit":{"default":15,"description":"Maximum notices and presidential documents to list, 1 to 50","maximum":50,"minimum":1,"title":"Limit","type":"integer"}},"title":"weekly_tariff_briefArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}