Skip to content
GiftUdevelopers
⌘ K
GuidesAPI referencev1.0.1

Catalog / API v1

Get a product

GET/api/partner/v1/products/{sku}

Current product detail.

Authentication

Authorization: Bearer <PARTNER_API_KEY>

Keys, environments, and IP policy

Path parameters

skustringrequired

min length: 1 · max length: 100

Response

Current product detail.

dataobjectrequired
Show fields
skustringrequired

max length: 100

nameArstringrequired
nameEnstringrequired
howToUseArstringrequired
howToUseEnstringrequired
imagestring | nullrequired
merchantobjectrequired
Show fields
idstringrequired
nameArstringrequired
nameEnstringrequired
categoryobjectrequired
Show fields
idstringrequired
nameArstringrequired
nameEnstringrequired
faceValuestring | nullrequired

Original provider denomination when supplied. SKU-only OneCard products may return null; it is never inferred from the SAR price.

faceValueCurrencystring | nullrequired

Paired with faceValue; both fields are null when denomination metadata is unavailable.

min length: 3 · max length: 3

priceMinorintegerrequired

Final VAT-inclusive gross SAR unit price, excluding any service fee, from configured partner pricing or, for partners not yet migrated, a legacy override or retail fallback.

int64 · min: 1 · max: 9007199254740991

priceCurrencystringrequired

"SAR"

priceSourcestringrequired

"PARTNER_PRICE" · "RETAIL_FALLBACK"

redemptionChannelstringrequired

"MERCHANT" · "GIFTU_APP"

requestIdstringrequired
errorobject | nullrequired

null

Need help with your integration?Talk to the GiftU team