Skip to main content
POST
Spree SDK

Authorizations

x-spree-api-key
string
header
required

Publishable API key for store access

Authorization
string
header
required

JWT token for authenticated customers

Headers

x-spree-api-key
string
required
Authorization
string
required
x-spree-token
string
Idempotency-Key
string

Unique key for request idempotency.

Path Parameters

cart_id
string
required

Cart prefixed ID (e.g., cart_abc123)

Body

application/json
amount
string<decimal>

Defaults to as much as the cart can use. A JSON number is still read until 6.1, with a deprecation warning.

Pattern: ^-?\d+(\.\d+)?$
Example:

"10.00"

Response

store credit applied

id
string
required
market_id
string | null
required
channel_id
string | null
required
preferred_stock_location_id
string | null
required
company_id
string | null
required
company_name
string | null
required
po_number_required
boolean
required
po_document_filename
string | null
required
po_document_byte_size
number | null
required
number
string
required
deprecated
token
string
required
email
string | null
required
customer_note
string | null
required
po_number
string | null
required
currency
enum<string>
required
Available options:
AED,
AFN,
ALL,
AMD,
ANG,
AOA,
ARS,
AUD,
AWG,
AZN,
BAM,
BBD,
BDT,
BGN,
BHD,
BIF,
BMD,
BND,
BOB,
BRL,
BSD,
BTN,
BWP,
BYN,
BYR,
BZD,
CAD,
CDF,
CHF,
CLF,
CLP,
CNY,
COP,
CRC,
CUC,
CUP,
CVE,
CZK,
DJF,
DKK,
DOP,
DZD,
EEK,
EGP,
ERN,
ETB,
EUR,
FJD,
FKP,
GBP,
GEL,
GHS,
GIP,
GMD,
GNF,
GTQ,
GYD,
HKD,
HNL,
HRK,
HTG,
HUF,
IDR,
ILS,
INR,
IQD,
IRR,
ISK,
JMD,
JOD,
JPY,
KES,
KGS,
KHR,
KMF,
KPW,
KRW,
KWD,
KYD,
KZT,
LAK,
LBP,
LKR,
LRD,
LSL,
LTL,
LVL,
LYD,
MAD,
MDL,
MGA,
MKD,
MMK,
MNT,
MOP,
MRO,
MRU,
MTL,
MUR,
MVR,
MWK,
MXN,
MYR,
MZN,
NAD,
NGN,
NIO,
NOK,
NPR,
NZD,
OMR,
PAB,
PEN,
PGK,
PHP,
PKR,
PLN,
PYG,
QAR,
RON,
RSD,
RUB,
RWF,
SAR,
SBD,
SCR,
SDG,
SEK,
SGD,
SHP,
SKK,
SLE,
SLL,
SOS,
SRD,
SSP,
STD,
STN,
SVC,
SYP,
SZL,
THB,
TJS,
TMM,
TMT,
TND,
TOP,
TRY,
TTD,
TWD,
TZS,
UAH,
UGX,
USD,
UYI,
UYU,
UYW,
UZS,
VED,
VEF,
VES,
VND,
VUV,
WST,
XAF,
XCD,
XCG,
XOF,
XPF,
YER,
ZAR,
ZMK,
ZMW,
ZWD,
ZWG,
ZWL,
ZWN,
ZWR
locale
enum<string> | null
required
Available options:
aa,
ab,
ae,
af,
ak,
am,
an,
ar,
as,
av,
ay,
az,
ba,
be,
bg,
bh,
bi,
bm,
bn,
bo,
br,
bs,
ca,
ce,
ch,
co,
cr,
cs,
cu,
cv,
cy,
da,
de,
de-AT,
de-CH,
dv,
dz,
ee,
el,
en,
en-AU,
en-CA,
en-GB,
en-IN,
en-NZ,
en-US,
eo,
es,
es-419,
es-CL,
es-EC,
es-MX,
et,
eu,
fa,
ff,
fi,
fj,
fo,
fr,
fr-CA,
fy,
ga,
gd,
gl,
gn,
gu,
gv,
ha,
he,
hi,
ho,
hr,
ht,
hu,
hy,
hz,
ia,
id,
ie,
ig,
ii,
ik,
io,
is,
it,
iu,
ja,
jv,
ka,
kg,
ki,
kj,
kk,
kl,
km,
kn,
ko,
kr,
ks,
ku,
kv,
kw,
ky,
la,
lb,
lg,
li,
ln,
lo,
lt,
lu,
lv,
mg,
mh,
mi,
mk,
ml,
mn,
mr,
ms,
mt,
my,
na,
nb,
nd,
ne,
ng,
nl,
nn,
no,
nr,
nv,
ny,
oc,
oj,
om,
or,
os,
pa,
pi,
pl,
ps,
pt,
pt-BR,
pt-PT,
qu,
rm,
rn,
ro,
ru,
rw,
sa,
sc,
sd,
se,
sg,
si,
sk,
sl,
sl-SI,
sm,
sn,
so,
sq,
sr,
ss,
st,
su,
sv,
sw,
ta,
te,
tg,
th,
ti,
tk,
tl,
tn,
to,
tr,
ts,
tt,
tw,
ty,
ug,
uk,
ur,
uz,
ve,
vi,
vo,
wa,
wo,
xh,
yi,
yo,
za,
zh-CN,
zh-HK,
zh-TW,
zu
total_quantity
number
required
warnings
object[]
required
coupon_code
string | null
required
item_total
string | null
required

The line items: each price times its quantity, before discounts, fees and delivery.

display_item_total
string | null
required
deprecated

item_total formatted with its currency symbol in the request's language.

discount_total
string | null
required

What promotions take off, as a negative amount. Manual discounts are not included.

display_discount_total
string | null
required
deprecated

discount_total formatted with its currency symbol in the request's language.

tax_total
string | null
required

All tax, both included in prices and added on top.

display_tax_total
string | null
required
deprecated

tax_total formatted with its currency symbol in the request's language.

included_tax_total
string | null
required

Tax already included in the prices, as in a store whose prices are tax-inclusive.

display_included_tax_total
string | null
required
deprecated

included_tax_total formatted with its currency symbol in the request's language.

additional_tax_total
string | null
required

Tax added on top of the prices.

display_additional_tax_total
string | null
required
deprecated

additional_tax_total formatted with its currency symbol in the request's language.

delivery_total
string | null
required

What delivery costs, before delivery discounts.

display_delivery_total
string | null
required
deprecated

delivery_total formatted with its currency symbol in the request's language.

fee_total
string | null
required

Every fee charged, such as handling or a customs duty.

display_fee_total
string | null
required
deprecated

fee_total formatted with its currency symbol in the request's language.

gift_card_total
string | null
required

What a gift card pays.

display_gift_card_total
string | null
required
deprecated

gift_card_total formatted with its currency symbol in the request's language.

store_credit_total
string | null
required

What store credit pays, apart from gift cards.

display_store_credit_total
string | null
required
deprecated

store_credit_total formatted with its currency symbol in the request's language.

total
string | null
required

What the customer pays in all: items, delivery, fees and added tax, less discounts.

display_total
string | null
required
deprecated

total formatted with its currency symbol in the request's language.

amount_due
string | null
required

What is left to pay after payments and store credit.

display_amount_due
string | null
required
deprecated

amount_due formatted with its currency symbol in the request's language.

covered_by_store_credit
boolean
required
payments
object[]
required
adjustment_total
string | null
required

Every discount, fee and added tax together, as one amount.

display_adjustment_total
string | null
required
deprecated

adjustment_total formatted with its currency symbol in the request's language.

current_step
string
required
completed_steps
string[]
required
requirements
object[]
required
order_minimum
string | null
required
order_minimum_shortfall
string | null
required
below_order_minimum
boolean | null
required
freight_summary
object | null
required
shipping_eq_billing_address
boolean
required
discounts
object[]
required
fees
object[]
required
items
object[]
required
fulfillments
object[]
required
billing_address
object | null
required
shipping_address
object | null
required
payment_methods
object[]
required
gift_card
object | null
required
market
object | null
required