Catalog / API v1

List products

GET/api/partner/v1/products

Invalid or duplicate SKUs are omitted before pagination. Totals count eligible products; an empty catalog returns 200 with an empty list.

Authentication

Authorization: Bearer <PARTNER_API_KEY>

Keys, environments, and IP policy

Query parameters

pageintegeroptional: default: 1 · min: 1
sizeintegeroptional: default: 20 · min: 1 · max: 100
searchstringoptional: max length: 100

Response

Current visible, available, allowed partner catalog.

dataobjectrequired

Show fields

itemsarrayrequired

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"

paginationobjectrequired

Show fields

pageintegerrequired
sizeintegerrequired
totalintegerrequired: int64
totalPagesintegerrequired

requestIdstringrequired

errorobject | nullrequired

null

Need help with your integration?Talk to the GiftU team