Orders / API v1

List orders

GET/api/partner/v1/orders

Orders belonging to the authenticated partner and key environment.

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

Orders belonging to the authenticated partner and key environment.

Cache-Control no-store

dataobjectrequired

Show fields

itemsarrayrequired

Show fields

orderIdstringrequired

uuid

partnerReferencestringrequired

statusstringrequired

"PROCESSING" · "COMPLETED" · "FAILED"

totalMinorintegerrequired

int64 · min: 1 · max: 9007199254740991

currencystringrequired

"SAR"

skustringrequired

productNameArstringrequired

productNameEnstringrequired

chargedPriceMinorintegerrequired

int64 · min: 1 · max: 9007199254740991

chargedCurrencystringrequired

"SAR"

faceValuestring | nullrequired

Frozen original provider denomination when supplied, not the charged SAR price. SKU-only OneCard orders may return null.

faceValueCurrencystring | nullrequired

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

min length: 3 · max length: 3

supportReferencestring | nullrequired

pollAfterSecondsinteger | nullrequired

Always non-null while status is PROCESSING, including manual review.

min: 1

createdAtstringrequired

date-time

updatedAtstringrequired

date-time

completedAtstring | nullrequired

date-time

paginationobjectrequired

Show fields

pageintegerrequired
sizeintegerrequired
totalintegerrequired: int64
totalPagesintegerrequired

requestIdstringrequired

errorobject | nullrequired

null

Need help with your integration?Talk to the GiftU team