Resolve an organization name to an EIN and canonical URL

Search text. Fewer than 2 characters returns an empty result set.

Which register to search: us (IRS, the default) or ca (CRA). Case-insensitive. One register per query, because revenue is the filing's own figure and the two currencies are never combined. Any other value is a 400, as is a value that contradicts the namespace of an organization key passed as q.

Narrow to a two-letter region code — a US state, or a province or territory under jurisdiction=ca. Case-insensitive; anything else is reported in x_plinth.warnings rather than applied as a filter that cannot match.

Rows to return. Capped at 50 — this endpoint resolves names, it does not page the corpus.

Lowest total revenue, whole units of the filing's own currency — US dollars, or Canadian dollars under jurisdiction=ca, which is stated back in x_plinth.warnings. Applied server-side, so it cannot drop matches past the cut.

Highest total revenue, in the same currency as min.

strict=1 turns any parameter this endpoint does not accept into a 400 instead of a warning.

Return a canned example response instead of querying the index — keyless, unmetered, and the only way to see this envelope without sending a real q. ?example=1 is the plain case; ?example=list names the others. Every example body carries x_plinth.example.