Get gift details

GET

/api/v1/marketplace/user/{userKey}/gifts/{id}

Get Gift Details

Retrieves the full details of a specific gift, including pricing, stock information, category, redemption rules, and custom messages.

This endpoint only returns active, non-expired gifts.

Returns 404 if the gift does not exist, is inactive, expired, or deleted

Returns 403 if the gift is private (targeted) and the user does not match the targeting criteria

Localization

Pass ?language=ar to resolve name, description, imageUrl, and redemptionMessage to that language. Falls back to defaults. No localizedContent map is returned to user-facing endpoints.

Request

Path Params

Query Params

Header Params

Responses

🟢200Success

application/json

Body

🟠403

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET 'https://api-stg.98s.studio//api/v1/marketplace/user/{{user-key}}/gifts/?language=ar' \
--header 'x-api-key: {{api-key}}'

Response Example

200 - Success

{
    "id": "b1c2d3e4-5678-9abc-def0-111111111111",
    "name": "سماعات فاخرة",
    "description": "سماعات لاسلكية عالية الجودة مع إلغاء الضوضاء",
    "imageUrl": "https://example.com/headphones-ar.png",
    "categoryId": "a1b2c3d4-5678-9abc-def0-111111111111",
    "categoryName": "Electronics",
    "pointId": "69962b0d0766fd3fe3c20116",
    "pricePoints": 500,
    "priceSar": 50,
    "priceDisplay": "Both",
    "isUnlimited": false,
    "remainingStock": 7,
    "ranking": 1,
    "expiresAt": "2026-12-31T23:59:59Z",
    "maxRedeemPerUser": 2,
    "collectCustomerInfo": true,
    "deliveryRequired": true,
    "redemptionValue": null,
    "redemptionMessage": "استمتع بسماعاتك الجديدة!",
    "status": "Active",
    "createdAt": "2026-03-20T09:00:00Z"
}

Modified at 2026-04-17 18:37:25

Browse available gifts for user

Redeem a gift

Get gift details

Get Gift Details#

Localization#

Request

Responses

Get Gift Details

Localization