Giftoin Docs
  • 👋INTRODUCTION
    • Welcome to Giftoin
    • Overview
    • Quick Start
    • FAQs
    • Key Features
  • 🧩API REFERENCE
    • Standards and Conventions
    • Orders API
      • Tokens/Points
      • Collectibles/Cards
      • Collectibles/Random Cards
    • Users API
      • Inventory
      • Progress
    • Error Handling
  • 💻PLATFORM GUIDES
    • Roblox
      • Why use Giftoin?
      • Basic Usage
      • Developer Access
      • Installation
      • Additional Example / Use-Cases
        • Point Reward
        • Daily Reward
        • Advanced Point Distribution System
        • Managed Codes & In-Game Rewards (Coming Soon)
          • Registering Reward Types
      • Tools and Scripts
        • Rotating Script
        • Floating Script
        • Quest System (Coming Soon)
    • Discord
      • Introduction
      • Getting Started
      • Command Reference
      • Role System
      • User Guides
      • Troubleshooting
      • FAQs
    • Wordpress
  • 📚Resources
    • Use Cases
      • Basic
      • eCommerce
      • Games
    • Support
Powered by GitBook
On this page

Was this helpful?

  1. API REFERENCE
  2. Users API

Progress

Get progress of user in collection-challenges

PreviousInventoryNextError Handling

Last updated 3 months ago

Was this helpful?

🧩

Get Overall Collections Progress

get

Retrieves the user's progress across all collections

Authorizations
Path parameters
platformstringRequired

The platform identifier (e.g., "discord", "roblox")

Example: discord
platformUserIdstringRequired

The user's ID on the specified platform

Example: 123456789012345678
Responses
200
Successful operation
application/json
400
Bad Request - Missing or invalid parameters
application/json
401
Unauthorized - API key is missing or invalid
application/json
get
GET /api/v1/users/{platform}/{platformUserId}/progress/collection-challenges HTTP/1.1
Host: api.giftoin.org
x-gft_api_key: YOUR_API_KEY
Accept: */*
[
  {
    "id": "program_123",
    "name": "Winter Challenge",
    "image": "https://example.com/images/winter-challenge.png",
    "description": "Collect all winter-themed cards",
    "size": 10,
    "cards": [
      {
        "name": "Snowflake Card",
        "id": "card_456",
        "image": "https://example.com/images/snowflake.png",
        "ownedQuantity": 2,
        "isOwned": true,
        "rarity": "rare"
      }
    ],
    "progressInPercentage": 30,
    "environment": "production",
    "createdTimestamp": 1644825600000,
    "timeLeft": 604800000,
    "reward": {
      "id": "reward_789",
      "name": "Winter Champion Badge",
      "image": "https://example.com/images/winter-badge.png",
      "description": "Awarded to those who complete the Winter Challenge",
      "isClaimed": false,
      "canClaim": false,
      "value": "text",
      "claimedTimestamp": 1,
      "viewType": "QR"
    },
    "status": "in_progress",
    "collectedCount": 3,
    "duration": {
      "start": {
        "date": 1644825600000,
        "showBefore": true
      },
      "end": {
        "date": 1647417600000,
        "showAfter": false
      }
    }
  }
]

Get One Collection Progress

get

Retrieves the user's progress for a specific collection

Authorizations
Path parameters
platformstringRequired

The platform identifier (e.g., "discord", "roblox")

Example: discord
platformUserIdstringRequired

The user's ID on the specified platform

Example: 123456789012345678
programIdstringRequired

The unique identifier for the program/collection

Example: program_123
Responses
200
Successful operation
application/json
400
Bad Request - Missing or invalid parameters
application/json
401
Unauthorized - API key is missing or invalid
application/json
get
GET /api/v1/users/{platform}/{platformUserId}/progress/collection-challenges/{programId} HTTP/1.1
Host: api.giftoin.org
x-gft_api_key: YOUR_API_KEY
Accept: */*
{
  "id": "program_123",
  "name": "Winter Challenge",
  "image": "https://example.com/images/winter-challenge.png",
  "description": "Collect all winter-themed cards",
  "size": 10,
  "cards": [
    {
      "name": "Snowflake Card",
      "id": "card_456",
      "image": "https://example.com/images/snowflake.png",
      "ownedQuantity": 2,
      "isOwned": true,
      "rarity": "rare"
    }
  ],
  "progressInPercentage": 30,
  "environment": "production",
  "createdTimestamp": 1644825600000,
  "timeLeft": 604800000,
  "reward": {
    "id": "reward_789",
    "name": "Winter Champion Badge",
    "image": "https://example.com/images/winter-badge.png",
    "description": "Awarded to those who complete the Winter Challenge",
    "isClaimed": false,
    "canClaim": false,
    "value": "text",
    "claimedTimestamp": 1,
    "viewType": "QR"
  },
  "status": "in_progress",
  "collectedCount": 3,
  "duration": {
    "start": {
      "date": 1644825600000,
      "showBefore": true
    },
    "end": {
      "date": 1647417600000,
      "showAfter": false
    }
  }
}
  • GETGet Overall Collections Progress
  • GETGet One Collection Progress