Rewards API endpoints

Endpoint to get all fan shop rewards filtered by partnerIds

get

/rewards

Authorizations

Query parameters

categoryIds[]string[] · default:

partnerIds[]string[] · default:

productTypeIds[]string[] · default:

sports[]string[] · default:

countries[]string[] · default:

statuses[]string[] · default:

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api-public.socios.com/rewards/1.0.0/rewards'

200

404

500

200

{
  "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,
      "publishedAt": "2023-07-27T14:24:09+00:00",
      "totalUserProductPurchases": 2,
      "createdAt": "2023-07-27T14:24:09+00:00",
      "updatedAt": "2023-07-27T14:24:09+00:00",
      "redeemType": "regular",
      "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",
          "availableStock": 2,
          "redeemableAt": "1690467849",
          "place": "stadium",
          "color": "red",
          "eventDate": "1690467849",
          "createdAt": "1690467849",
          "updatedAt": "1690467849",
          "status": "enabled",
          "seatSection": "home",
          "size": "XXS",
          "edition": "signed",
          "gender": "male",
          "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"
        }
      ],
      "productTierLevel": {
        "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
        "name": "Tier I",
        "minTokenRequired": 2,
        "createdAt": "2023-07-27T14:24:09+00:00",
        "updatedAt": "2023-07-27T14:24:09+00:00"
      },
      "country": {
        "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
        "name": "Italy"
      },
      "sportType": [
        {
          "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
          "name": "Footbal"
        }
      ]
    }
  ]
}

Success

Endpoint to get all fan shop reward categories

get

/reward-categories

Authorizations

Query parameters

partnerIds[]string[] · default:

productTypeIds[]string[] · default:

sports[]string[] · default:

countries[]string[] · default:

statuses[]string[] · default:

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api-public.socios.com/rewards/1.0.0/reward-categories'

200

404

500

200

{
  "data": [
    {
      "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
      "name": "Club rewards",
      "parentCategoryId": "63967271-a6f3-40bc-b431-f4df86ad37e5",
      "color": "#9F2B68",
      "createdAt": "2023-07-27T14:24:09+00:00",
      "updatedAt": "2023-07-27T14:24:09+00:00",
      "status": "enabled"
    }
  ]
}

Success

Get details of a single reward

get

/rewards/{rewardId}

Authorizations

Path parameters

rewardIdstringrequired

Responses

application/json

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://api-public.socios.com/rewards/1.0.0/rewards/{rewardId}'

200

404

500

200

{
  "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,
    "publishedAt": "2023-07-27T14:24:09+00:00",
    "totalUserProductPurchases": 2,
    "createdAt": "2023-07-27T14:24:09+00:00",
    "updatedAt": "2023-07-27T14:24:09+00:00",
    "redeemType": "regular",
    "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",
        "availableStock": 2,
        "redeemableAt": "1690467849",
        "place": "stadium",
        "color": "red",
        "eventDate": "1690467849",
        "createdAt": "1690467849",
        "updatedAt": "1690467849",
        "status": "enabled",
        "seatSection": "home",
        "size": "XXS",
        "edition": "signed",
        "gender": "male",
        "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"
      }
    ],
    "productTierLevel": {
      "id": "d36fe9b1-b524-4c82-a691-7b89cda36b4a",
      "name": "Tier I",
      "minTokenRequired": 2,
      "createdAt": "2023-07-27T14:24:09+00:00",
      "updatedAt": "2023-07-27T14:24:09+00:00"
    }
  }
}

Success