Get a tax rate - Spree Commerce documentation

Spree Admin SDK

import { createAdminClient } from '@spree/admin-sdk'

const client = createAdminClient({
  baseUrl: 'https://your-store.com',
  secretKey: 'sk_xxx',
})

const taxRate = await client.taxRates.get('tax_UkLWZg9DAJ')

{
  "id": "tax_UkLWZg9DAJ",
  "name": "TaxRate - 312890",
  "show_rate_in_label": true,
  "metadata": {},
  "created_at": "2026-01-15T12:00:00.000Z",
  "updated_at": "2026-01-15T12:00:00.000Z",
  "deleted_at": null,
  "rate": "0.19",
  "rate_percent": "19",
  "tax_category_id": "taxcat_UkLWZg9DAJ",
  "store_id": "store_UkLWZg9DAJ",
  "country_code": "DE",
  "state_code": null
}

GET

/

api

/

v3

/

admin

/

tax_rates

/

{id}

Spree Admin SDK

import { createAdminClient } from '@spree/admin-sdk'

const client = createAdminClient({
  baseUrl: 'https://your-store.com',
  secretKey: 'sk_xxx',
})

const taxRate = await client.taxRates.get('tax_UkLWZg9DAJ')

{
  "id": "tax_UkLWZg9DAJ",
  "name": "TaxRate - 312890",
  "show_rate_in_label": true,
  "metadata": {},
  "created_at": "2026-01-15T12:00:00.000Z",
  "updated_at": "2026-01-15T12:00:00.000Z",
  "deleted_at": null,
  "rate": "0.19",
  "rate_percent": "19",
  "tax_category_id": "taxcat_UkLWZg9DAJ",
  "store_id": "store_UkLWZg9DAJ",
  "country_code": "DE",
  "state_code": null
}

Authorizations

x-spree-api-key

string

header

required

Secret API key for admin access

Authorization

string

header

required

JWT token for admin user authentication

Headers

x-spree-api-key

string

required

Authorization

string

required

Bearer token for admin authentication

Path Parameters

id

string

required

Tax rate ID

Response

200 - application/json

tax rate found

id

string

required

name

string

required

show_rate_in_label

boolean

required

metadata

object | null

required

created_at

string

required

updated_at

string

required

deleted_at

string | null

required

rate

string | null

required

rate_percent

string | null

required

tax_category_id

string | null

required

store_id

string | null

required

country_code

enum<string> | null

required

Available options:

AD,

AE,

AF,

AG,

AI,

AL,

AM,

AO,

AR,

AS,

AT,

AU,

AW,

AZ,

BA,

BB,

BD,

BE,

BF,

BG,

BH,

BI,

BJ,

BL,

BM,

BN,

BO,

BQ,

BR,

BS,

BT,

BW,

BY,

BZ,

CA,

CC,

CD,

CF,

CG,

CH,

CI,

CK,

CL,

CM,

CN,

CO,

CR,

CU,

CV,

CW,

CX,

CY,

CZ,

DE,

DJ,

DK,

DM,

DO,

DZ,

EC,

EE,

EG,

ER,

ES,

ET,

FI,

FJ,

FK,

FM,

FO,

FR,

GA,

GB,

GD,

GE,

GF,

GG,

GH,

GI,

GL,

GM,

GN,

GP,

GQ,

GR,

GT,

GU,

GW,

GY,

HK,

HN,

HR,

HT,

HU,

ID,

IE,

IL,

IM,

IN,

IQ,

IR,

IS,

IT,

JE,

JM,

JO,

JP,

KE,

KG,

KH,

KI,

KM,

KN,

KP,

KR,

KW,

KY,

KZ,

LA,

LB,

LC,

LI,

LK,

LR,

LS,

LT,

LU,

LV,

LY,

MA,

MC,

MD,

ME,

MF,

MG,

MH,

MK,

ML,

MM,

MN,

MO,

MP,

MQ,

MR,

MS,

MT,

MU,

MV,

MW,

MX,

MY,

MZ,

NA,

NC,

NE,

NF,

NG,

NI,

NL,

NO,

NP,

NR,

NU,

NZ,

OM,

PA,

PE,

PF,

PG,

PH,

PK,

PL,

PM,

PN,

PR,

PS,

PT,

PW,

PY,

QA,

RE,

RO,

RS,

RU,

RW,

SA,

SB,

SC,

SD,

SE,

SG,

SH,

SI,

SJ,

SK,

SL,

SM,

SN,

SO,

SR,

SS,

ST,

SV,

SX,

SY,

SZ,

TC,

TD,

TG,

TH,

TJ,

TK,

TL,

TM,

TN,

TO,

TR,

TT,

TV,

TW,

TZ,

UA,

UG,

US,

UY,

UZ,

VA,

VC,

VE,

VG,

VI,

VN,

VU,

WF,

WS,

YE,

YT,

ZA,

ZM,

ZW

state_code

string | null

required

⌘I