Skip to main content
Treaty material sits behind two corpusType tokens. US_TAX_TREATY holds the IRS income tax treaties. US_TREATY holds the Senate treaty record. They were split on 2026-11-06, so a search for one never returns the other.

What the two tokens hold

Counts measured 2026-11-06. A document is one citable item. A retrieval passage is one searchable chunk of it.
GET /us/statutes/coverage reports sectionCount 1,665 for US_TAX_TREATY and 1,492 for US_TREATY. The endpoint counts sections, not documents. The 173 documents of US_TAX_TREATY are counted there as 1,665 sections. Both numbers are correct.

Sources

Narrow either token to one body of material with source. The 102 documents of us_tax_treaty are 71 bilateral income tax conventions for 68 countries, 23 protocols, 6 exchanges of notes, 1 memorandum of understanding and 1 negotiation statement. A protocol is served as its own document rather than folded into the convention it amends. That keeps each protocol searchable on its own terms, such as a change to a withholding rate, a limitation-on-benefits article or an entry-into-force date. The 303 documents of senate_treaty_document are 285 numbered Treaty Documents and 18 Serial Set packages.

Where the text comes from

Searching and filtering

Both tokens use the same search route, POST /us/statutes/search, and the same corpusType and source filters described in Corpus types. Find a withholding rule in an IRS income tax treaty:
Read the Treasury’s explanation of a treaty instead of the treaty itself:
Find the reservations and understandings the Senate attached to its consent:
corpusType also accepts a list, so one call can search both tokens:

Citations

A treaty citation is always recognized as a treaty. It is never read as a U.S. Code section or a Public Law. The full list of accepted forms is in Treaty citations. The missReasonHint states that the form was recognized and lists the treaty material we do hold: the Senate ratification record, Treaty Document text from 1995 on, and the IRS income tax treaties.

Limits

  • About 60% of the Senate record is metadata with no instrument text. source tells you which records those are.
  • goodLawStatus is unknown on every treaty record. No source we hold states termination.
  • Treaty text printed in the Statutes at Large, U.S.T., T.I.A.S. and Bevans is not held.
  • Senate Executive Reports are not held.
  • The categories us_treaty and senate_executive_report exist on the US_TREATY token and hold no documents.
  • US_TAX_TREATY covers income tax only. There are no estate or gift tax treaties.
For the other federal tokens, see Federal coverage.
Last modified on November 6, 2026