List Tax Rates

Returns the store-wide list of tax rates as a cursor-paginated connection. Each node is one tax rate — a rule that defines the tax percentage applied to a location, identified by country/state and either a single zip code or a zip-code range.

Operation

Operation	Type	Purpose
adminSettingsTaxRates(first: Int, after: String)	QueryCollection	List tax rates with cursor pagination

Arguments

All arguments are optional and combine in a single query — filter, sort and paginate together.

Pagination

Argument	Description
first	Number of records to return.
after	Cursor to fetch the page after (from pageInfo.endCursor).

Filters

Each filter narrows the result; supplying more than one combines with logical AND.

Argument	Type	Match	Example
identifier	String	Partial (contains).	"AUDIT"
country	String	Exact — two-letter ISO code.	"US"
state	String	Exact.	"CA"
tax_rate_from	Float	Minimum tax rate (inclusive).	5
tax_rate_to	Float	Maximum tax rate (inclusive).	10

Sorting

Argument	Type	Values
sort	String	id (default), identifier, tax_rate
order	String	asc, desc (default desc)

Fields

Field	Meaning
isZip	true when the rate targets a zip range (zipFrom–zipTo); false when it targets a single zipCode.
zipCode	The single zip code the rate applies to. Populated only when isZip is false.
zipFrom / zipTo	The start and end of the zip range. Populated only when isZip is true.
state / country	The location the rate applies to. country is a two-letter ISO code.
taxRate	The tax percentage (0–100).

For how tax rates fit together with tax categories, see the menu overview.