1. Marketplace
Game Loom
  • Game Loom
    • 👋 Welcome to Game Loom
  • Getting started
    • Introduction
    • 👤 Authentication
  • User Registration
    • Introduction
    • Get Countries
      GET
    • Get Cities
      GET
    • Single user registration
      POST
    • Bulk Register Users
      POST
  • Notifications
    • Overview
    • Receiving Event Notifications via Webhooks
    • Get All notifications for specific user
      GET
  • Rewards
    • Overview
    • Integrate with you reward system
    • Points
      • Record user point event
      • Get user points
      • Get Specific user point
    • Levels
      • Record user level event
      • Get user levels
      • Get Specific user level
    • Badges
      • Award badge to user
      • Get user badges
      • Get Specific user badge
  • Challenges (Gamification elements)
    • Introduction
    • Leaderboard
      • Get available leaderboards for user
      • Submit score to a leaderboard
      • Get user's leaderboard participation history
      • Get leaderboard details
      • Get leaderboard ranking
      • Get user's record for a leaderboard
      • Get user's entry history for a leaderboard
    • Survey
      • Overview
      • Get available surveys for user
      • Start a new survey participation
      • Get detailed user participation
      • Get user's survey participation history
      • Abandon survey participation
      • Save individual answer to survey question
      • Submit completed survey
      • Submit Survey with answers (One-Step Submission)
    • Quiz
      • Get available quizzes for user
      • Submit complete quiz answers
      • Get comprehensive user quiz history
      • Get comprehensive quiz attempt details
    • Open Challenge
      • Overview
      • Get available open challenges for user
      • Complete an open challenge
      • Get user's open challenge participation history
      • Get user open challenge by ID
    • Schemas
      • Survey Schame
  • MarketPlace
    • Overview
    • Marketplace
      • Browse available gifts for user
        GET
      • Get gift details
        GET
      • Redeem a gift
        POST
      • Get user's redemption history
        GET
    • Schemas
      • ProblemDetails
  1. Marketplace

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 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 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
Previous
Browse available gifts for user
Next
Redeem a gift
Built with