White Logo

Distribution

A distribution service is a convenient platform that offers a catalog of various products. It allows users to access and obtain a comprehensive list of products available for distribution. Additionally, the service enables users to obtain detailed information about individual products, such as specifications, pricing, and availability. This facilitates efficient distribution processes by providing a centralized hub for managing and acquiring products from multiple suppliers or manufacturers.

GET/v1/catalog

Get Catalog

This endpoint is a GET request that allows resellers, who have registered on the platform, to retrieve their catalog. The catalog refers to a collection of products available for distribution.

Request

GET
/v1/catalog
curl -X GET \
  -H "Authorization: Bearer <ACCESS_TOKEN>" \
  https://api.kalixo.io/v1/catalog

Response

{
  "id": 1,
  "name": "shop",
  "fromDate": "2021-01-22T01:00:00.000Z",
  "toDate": null,
  "status": "active",
  "description": "Main catalog",
  "catalogTypeId": 1,
  "resellerId": 1,
  "createdAt": "2021-01-21T01:00:00.000Z",
  "updatedAt": "2021-01-21T01:00:00.000Z",
  "deletedAt": null
}
GET/v1/catalog/products

Get Products from Catalog

This endpoint is a GET request that retrieves a subset of products from the catalog belonging to a registered reseller.

This endpoint allows users to fetch a specific range of products based on the provided parameters. The "skip" parameter determines the number of products to skip, while the "take" parameter specifies the maximum number of products to retrieve. In this example, the request fetches 30 products starting from the second product (skipping the first one).

Request

GET
/v1/catalog/products?skip=1&take=30
curl -X GET \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
https://api.kalixo.io/v1/catalog/products?skip=1&take=30

Response

{
	"count": 2083,
	"take": 30,
	"skip": 1,
	"products": [
		...,
		{
			"id": 1,
			"ean": "4251604177254",
			"rrp": "10.99",
			"rrpCurrency": "GBP",
			"brand": "Microsoft",
      "publisher": "Microsoft Xbox ESD (UK)",
			"countryCode": "GB",
			"currencyCode": "GBP",
			"price": 1099,
      "denominationType": "fixed",
			"mainCategory": "Xbox",
			"categoryType": "Console",
			"subCategory": "Game Pass",
			"productType": "Subscription",
			"tags": "Xbox, Subscription, Microsoft, Digital Code, Game Pass",
      "status": "active",
      "state": "live",
      "type": "digital",
			"languages": [
				...,
				{
					"languageCode": "en",
					"name": "Xbox Game Pass Ultimate 1 month",
					"sku": "GB-EN-4251604177254",
					"image": "https://cdn.kalixo.io/static-images/GB-EN-4251604177254.png",
					"descriptionHtml": "Get all the benefits of Xbox Live Gold, plus over 100 high-quality console and PC games for one low monthly price. With games added all the time, there’s always something new to play. With a huge variety of games from every genre, there’s something for everyone. Enjoy exclusive member deals and discounts. . Plus, enjoy free perks, including in-game content, consumables, and partner offers. Play together with friends on the most advanced multiplayer network and discover your next favorite game.\n\nUse your active Xbox Game Pass Ultimate membership to play games on Xbox One and Windows 10 PC (excludes Windows 10 in S mode and on ARM devices). Xbox Game Pass Ultimate includes Xbox Game Pass for Console, Xbox Game Pass for PC, Xbox Live Gold and additional benefits.",
					"description": "Get all the benefits of Xbox Live Gold, plus over 100 high-quality console and PC games for one low monthly price. With games added all the time, there’s always something new to play. With a huge variety of games from every genre, there’s something for everyone. Enjoy exclusive member deals and discounts. . Plus, enjoy free perks, including in-game content, consumables, and partner offers. Play together with friends on the most advanced multiplayer network and discover your next favorite game.\n\nUse your active Xbox Game Pass Ultimate membership to play games on Xbox One and Windows 10 PC (excludes Windows 10 in S mode and on ARM devices). Xbox Game Pass Ultimate includes Xbox Game Pass for Console, Xbox Game Pass for PC, Xbox Live Gold and additional benefits.",
					"tncHtml": "<a href=\"https://microsoft.com/cardterms\">microsoft.com/cardterms</a>",
					"tnc": "microsoft.com/cardterms",
					"redemptionInstructionsHtml": "NO EXPIRATION DATE AND NO\nSERVICE FEE\n\nREDEEM CODE:\n\n1. Go to <a href=\"https://microsoft.com/redeem\">microsoft.com/redeem</a>\n2. Enter your code\n\nTo create a new Microsoft account\nor read the full conditions\n(which can change without\nprior notice), go to\n<a href=\"https://microsoft.com/cardterms\">microsoft.com/cardterms</a>.\n\n(Code cannot be replaced - please\nkeep in a safe place)",
					"redemptionInstructions": "NO EXPIRATION DATE AND NO\nSERVICE FEE\n\nREDEEM CODE:\n\n1. Go to microsoft.com/redeem\n2. Enter your code\n\nTo create a new Microsoft account\nor read the full conditions\n(which can change without\nprior notice), go to\nmicrosoft.com/cardterms.\n\n(Code cannot be replaced - please\nkeep in a safe place)"
				},
				...
			],
			"image": "https://cdn.kalixo.io/static-images/GB-EN-4251604177254.png",
			"shortName": "Microsoft Xbox Game Pass Ult 1M ESD UK",
			"name": "Xbox Game Pass Ultimate 1 month"
		},
		...
	]
}
GET/v1/catalog/product?ean=4251604177254

Get Single Product from Catalog via EAN or SKU

This endpoint is a GET request that retrieves a specific product from the catalog based on the provided EAN (European Article Number) code.

In this example, the EAN parameter is mandatory, and it uniquely identifies the desired product. The endpoint expects the EAN code to be provided as a query parameter.

Request

GET
/v1/catalog/product?ean=4251604177254
curl -X GET \
-H "Authorization: Bearer <ACCESS_TOKEN>" \
https://api.kalixo.io/v1/catalog/product?ean=4251604177254

Response

{
    "id": 1,
    "ean": "4251604177254",
    "rrp": "10.99",
    "rrpCurrency": "GBP",
    "brand": "Microsoft",
    "countryCode": "GB",
    "currencyCode": "GBP",
    "price": "1099.00",
    "mainCategory": "Xbox",
    "categoryType": "Console",
    "subCategory": "Game Pass",
    "productType": "Subscription",
    "tags": "Xbox, Subscription, Microsoft, Digital Code, Game Pass",
    "languages": [
        ...,
        {
            "languageCode": "en",
            "name": "Xbox Game Pass Ultimate 1 month",
            "sku": "GB-EN-4251604177254",
            "image": "https://cdn.kalixo.io/static-images/GB-EN-4251604177254.png",
            "description": "Get all the benefits of Xbox Live Gold, plus over 100 high-quality console and PC games for one low monthly price. With games added all the time, there’s always something new to play. With a huge variety of games from every genre, there’s something for everyone. Enjoy exclusive member deals and discounts. . Plus, enjoy free perks, including in-game content, consumables, and partner offers. Play together with friends on the most advanced multiplayer network and discover your next favorite game.\n\nUse your active Xbox Game Pass Ultimate membership to play games on Xbox One and Windows 10 PC (excludes Windows 10 in S mode and on ARM devices). Xbox Game Pass Ultimate includes Xbox Game Pass for Console, Xbox Game Pass for PC, Xbox Live Gold and additional benefits.",
            "tnc": "<a href=\"https://microsoft.com/cardterms\">microsoft.com/cardterms</a>",
            "redemptionInstructions": "NO EXPIRATION DATE AND NO\nSERVICE FEE\n\nREDEEM CODE:\n\n1. Go to <a href=\"https://microsoft.com/redeem\">microsoft.com/redeem</a>\n2. Enter your code\n\nTo create a new Microsoft account\nor read the full conditions\n(which can change without\nprior notice), go to\n<a href=\"https://microsoft.com/cardterms\">microsoft.com/cardterms</a>.\n\n(Code cannot be replaced - please\nkeep in a safe place)"
        },
        ...
    ],
    "image": "https://cdn.kalixo.io/static-images/GB-EN-4251604177254.png",
    "shortName": "Microsoft Xbox Game Pass Ult 1M ESD UK",
    "name": "Xbox Game Pass Ultimate 1 month"
}