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

Request

Path Params

Header Params

Responses

🟢200Success

application/json

Body

🟠403

🟠404

Request Example

Shell

JavaScript

Java

Swift

curl --location -g --request GET '/api/v1/marketplace/user/{{user-key}}/gifts/' \
--header 'x-api-key: {{api-key}}'

Response Example

200 - Success

{
    "id": "b1c2d3e4-5678-9abc-def0-111111111111",
    "name": "Premium Headphones",
    "description": "High-quality wireless headphones with noise cancellation",
    "imageUrl": "https://example.com/headphones.png",
    "categoryId": "a1b2c3d4-5678-9abc-def0-111111111111",
    "categoryName": "Electronics",
    "pointTypeIds": [
        "68e3ee00d81b74c5fe9ac28c"
    ],
    "pricePoints": 500,
    "priceSar": 50,
    "priceDisplay": "Both",
    "isUnlimited": false,
    "quantity": 10,
    "remainingStock": 7,
    "ranking": 1,
    "expiresAt": "2026-12-31T23:59:59Z",
    "maxRedeemPerUser": 2,
    "collectCustomerInfo": true,
    "deliveryRequired": true,
    "isPublic": true,
    "redemptionValue": null,
    "redemptionMessageEn": "Enjoy your new headphones!",
    "redemptionMessageAr": "استمتع بسماعاتك الجديدة!",
    "status": "Active",
    "createdAt": "2026-03-20T09:00:00Z",
    "updatedAt": "2026-03-21T11:30:00Z"
}

Modified at 2026-04-13 23:17:31

Browse available gifts for user

Redeem a gift

Get gift details

Get Gift Details#

Request

Responses

Get Gift Details