Product Catalog API

Get the list of the Bando Fulfiller Catalog.

Overview

This API fetches a paginated list of products available for payment with the bando fulfillment protocol.

Objectives

The most common use for this API would be to populate a UI that enlists the available services to spend for your wallet / Dapp / game / metaverse, etc.

API Specification

Get list of existing products grouped by product type

GEThttps://api.bando.cool/v1/products/grouped

Query parameters

Response

200400401403500

OK

Body

application/json

productsarray of object

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.bando.cool/v1/products/grouped', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400401403500

{
  "products": [
    {
      "productType": "text",
      "brands": [
        {
          "brandName": "text",
          "brandSlug": "text",
          "imageUrl": "text",
          "order": 1,
          "variants": [
            {
              "id": "text",
              "fupId": "text",
              "brand": "text",
              "country": "text",
              "notes": "text",
              "sku": "text",
              "price": {
                "fiatCurrency": "text",
                "fiatValue": "text",
                "stableCoinCurrency": "text",
                "stableCoinValue": "text"
              },
              "productType": "text",
              "referenceType": {
                "name": "text",
                "valueType": "text",
                "regex": "text"
              },
              "requiredFields": [
                {
                  "name": "text",
                  "valueType": "text",
                  "regex": "text"
                }
              ],
              "shortNotes": "text",
              "subTypes": [
                "text"
              ],
              "imageUrl": "text",
              "evmServiceId": 1,
              "svmServiceId": 1,
              "dataGB": 1,
              "dataSpeeds": [
                "text"
              ],
              "dataUnlimited": true,
              "durationDays": 1,
              "smsNumber": 1,
              "smsUnlimited": true,
              "voiceMinutes": 1,
              "voiceUnlimited": true,
              "roamingCountryIso2": "text",
              "roamingDataSpeeds": [
                "text"
              ]
            }
          ]
        }
      ]
    }
  ]
}

Get list of existing products

GEThttps://api.bando.cool/v1/products

Query parameters

Response

200400401403500

OK

Body

application/json

totalItemsinteger

Total number of products

totalPagesinteger

Total number of pages

currentPageinteger

Current page

productsarray of one of

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.bando.cool/v1/products', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200400401403500

{
  "totalItems": 1,
  "totalPages": 1,
  "currentPage": 1,
  "products": [
    {
      "id": "text",
      "fupId": "text",
      "brand": "text",
      "country": "text",
      "notes": "text",
      "sku": "text",
      "price": {
        "fiatCurrency": "text",
        "fiatValue": "text",
        "stableCoinCurrency": "text",
        "stableCoinValue": "text"
      },
      "productType": "text",
      "referenceType": {
        "name": "text",
        "valueType": "text",
        "regex": "text"
      },
      "requiredFields": [
        {
          "name": "text",
          "valueType": "text",
          "regex": "text"
        }
      ],
      "shortNotes": "text",
      "subTypes": [
        "text"
      ],
      "imageUrl": "text",
      "evmServiceId": 1,
      "svmServiceId": 1,
      "dataGB": 1,
      "dataSpeeds": [
        "text"
      ],
      "dataUnlimited": true,
      "durationDays": 1,
      "smsNumber": 1,
      "smsUnlimited": true,
      "voiceMinutes": 1,
      "voiceUnlimited": true,
      "roamingCountryIso2": "text",
      "roamingDataSpeeds": [
        "text"
      ]
    }
  ]
}