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 user's redemption history

GET
/api/v1/marketplace/user/{userKey}/redemptions

Get Redemption History#

Retrieves the user's gift redemption history, including gift details, points spent, order status, and delivery status.
Results are sorted by creation date (newest first).
Users can only view their own redemptions.

Request

Path Params

Query Params

Header Params

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET '/api/v1/marketplace/user/{{user-key}}/redemptions?pageNumber=1&pageSize=10' \
--header 'x-api-key: {{api-key}}'
Response Response Example
{
    "items": [
        {
            "id": "c1d2e3f4-5678-9abc-def0-111111111111",
            "userId": "user-001",
            "giftName": "Premium Headphones",
            "giftImageUrl": "https://example.com/headphones.png",
            "pointsSpent": 500,
            "orderStatus": "Completed",
            "deliveryStatus": "Pending",
            "deliveryRequired": true,
            "customerName": "Ahmed Mohammed",
            "customerPhone": "+966500000001",
            "createdAt": "2026-03-22T16:00:00Z"
        },
        {
            "id": "c1d2e3f4-5678-9abc-def0-222222222222",
            "userId": "user-001",
            "giftName": "Coffee Voucher",
            "giftImageUrl": null,
            "pointsSpent": 100,
            "orderStatus": "Completed",
            "deliveryStatus": null,
            "deliveryRequired": false,
            "customerName": null,
            "customerPhone": null,
            "createdAt": "2026-03-21T10:00:00Z"
        },
        {
            "id": "c1d2e3f4-5678-9abc-def0-333333333333",
            "userId": "user-001",
            "giftName": "Movie Ticket",
            "giftImageUrl": "https://example.com/movie.png",
            "pointsSpent": 200,
            "orderStatus": "Cancelled",
            "deliveryStatus": null,
            "deliveryRequired": false,
            "customerName": null,
            "customerPhone": null,
            "createdAt": "2026-03-19T08:30:00Z"
        }
    ],
    "pagination": {
        "currentPage": 1,
        "pageSize": 10,
        "totalCount": 3,
        "totalPages": 1,
        "hasPrevious": false,
        "hasNext": false
    }
}
Modified at 2026-04-13 23:17:31
Previous
Redeem a gift
Next
ProblemDetails
Built with