Skip to content

Get a Tax Category

Returns a single tax category by id, with its attached tax rates inlined. This is the only operation that resolves the taxRates list — on the listing it is always null.

Operation

OperationTypePurpose
adminSettingsTaxCategory(id: ID!)QueryFetch one tax category with its attached rates

Fields

FieldMeaning
_idNumeric tax-category id.
idThe category's resource path — pass this as the $id variable.
codeUnique machine code.
nameDisplay name.
descriptionFree-text description.
taxRatesThe attached tax rates, returned as a connection — select taxRates { edges { node { _id identifier taxRate } } }. Each node carries the rate's _id, identifier, and taxRate (the percentage). Empty edges means no rates are currently attached.
createdAt / updatedAtISO 8601 timestamps.

taxRates is a field-selectable connection

taxRates is a Relay connection, not an opaque value — sub-select the fields you need via taxRates { edges { node { _id identifier taxRate } } }.

Finding ids

Use the adminSettingsTaxCategories query to discover valid ids. Pass the category's resource path (/api/admin/settings/tax-categories/{id}) as $id.

Released under the MIT License.