Rewards API endpoints

Endpoint to get all fan shop rewards filtered by partnerIds

GEThttps://api-public.socios.com/rewards/1.0.0/rewards

Authorization

default

Query parameters

Response

200404500

Success

Body

application/json

dataarray of FanShopReward (object)

Request

JavaScriptCurl

const response = await fetch('https://api-public.socios.com/rewards/1.0.0/rewards', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": [
    {
      "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
      "name": "Signed jersey",
      "description": "Signed jersey description",
      "sellingPrice": "20.5",
      "partnerId": "cf7a5894-ac9d-4157-8998-e0eaa80b0bc0",
      "maxUserPurchase": 2,
      "canUserUseProductTierLevel": true,
      "categories": [
        {
          "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
          "name": "Club rewards",
          "status": "enabled"
        }
      ],
      "productType": [
        {
          "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
          "name": "Generic Physical"
        }
      ],
      "productVariant": [
        {
          "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
          "label": "Signed jersey size M",
          "status": "enabled",
          "availableStock": 2,
          "redeemableAt": "1690467849",
          "place": "stadium",
          "seatSection": "home",
          "size": "XXS",
          "color": "red",
          "edition": "signed",
          "gender": "male",
          "eventDate": "1690467849",
          "createdAt": "1690467849",
          "updatedAt": "1690467849",
          "assets": [
            {
              "url": "https://url.com/partner/d66eb9d2-56c6-4b1b-8f56-31f8aa319abe/partner_logo/38aca876-86a8-4a10-a0e8-b0859614c8b3.png?version=1653577420",
              "type": "jpg",
              "format": "mobile",
              "width": "500",
              "height": "500"
            }
          ]
        }
      ],
      "tags": [
        {
          "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
          "name": "Club rewards",
          "status": "enabled"
        }
      ],
      "assets": [
        {
          "url": "https://url.com/partner/d66eb9d2-56c6-4b1b-8f56-31f8aa319abe/partner_logo/38aca876-86a8-4a10-a0e8-b0859614c8b3.png?version=1653577420",
          "type": "jpg",
          "format": "mobile",
          "width": "500",
          "height": "500"
        }
      ],
      "totalUserProductPurchases": 2,
      "createdAt": "1690467849",
      "updatedAt": "1690467849"
    }
  ]
}

Get details of a single reward

GEThttps://api-public.socios.com/rewards/1.0.0/rewards/{rewardId}

Authorization

default

Path parameters

rewardId*string

Response

200404500

Success

Body

application/json

dataFanShopReward (object)

Request

JavaScriptCurl

const response = await fetch('https://api-public.socios.com/rewards/1.0.0/rewards/{rewardId}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

{
  "data": {
    "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
    "name": "Signed jersey",
    "description": "Signed jersey description",
    "sellingPrice": "20.5",
    "partnerId": "cf7a5894-ac9d-4157-8998-e0eaa80b0bc0",
    "maxUserPurchase": 2,
    "canUserUseProductTierLevel": true,
    "categories": [
      {
        "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
        "name": "Club rewards",
        "status": "enabled"
      }
    ],
    "productType": [
      {
        "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
        "name": "Generic Physical"
      }
    ],
    "productVariant": [
      {
        "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
        "label": "Signed jersey size M",
        "status": "enabled",
        "availableStock": 2,
        "redeemableAt": "1690467849",
        "place": "stadium",
        "seatSection": "home",
        "size": "XXS",
        "color": "red",
        "edition": "signed",
        "gender": "male",
        "eventDate": "1690467849",
        "createdAt": "1690467849",
        "updatedAt": "1690467849",
        "assets": [
          {
            "url": "https://url.com/partner/d66eb9d2-56c6-4b1b-8f56-31f8aa319abe/partner_logo/38aca876-86a8-4a10-a0e8-b0859614c8b3.png?version=1653577420",
            "type": "jpg",
            "format": "mobile",
            "width": "500",
            "height": "500"
          }
        ]
      }
    ],
    "tags": [
      {
        "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
        "name": "Club rewards",
        "status": "enabled"
      }
    ],
    "assets": [
      {
        "url": "https://url.com/partner/d66eb9d2-56c6-4b1b-8f56-31f8aa319abe/partner_logo/38aca876-86a8-4a10-a0e8-b0859614c8b3.png?version=1653577420",
        "type": "jpg",
        "format": "mobile",
        "width": "500",
        "height": "500"
      }
    ],
    "totalUserProductPurchases": 2,
    "createdAt": "1690467849",
    "updatedAt": "1690467849"
  }
}