Calendar

Represents a scheduled game, match, or tournament instance—essentially, a time-bound event associated with a specific Field.

The Calendar object anchors the gameplay timeline, enabling season-based, game-based, or tournament-based fan campaigns. Examples:

• UEFA Champions League Final: Madrid vs PSG, for a single event calendar.

• LaLiga 2025-2026, including multiple matches, for the entire season calendar.

new_calendar

POST https://api.bws.ninja/v1/call

Request Body

Name	Type	Description
solution*	string	BWS.NFT.GameCube
operation*	string	new_calendar
parameters*	JSON	check method parameters

new_field Method Parameters

Parameter	Type	Desciption
name	string	Calendar name (e.g. LaLiga 2025-26)

new_calendar API Call Example

new_field API call using Node.js

const axios = require('axios');

/* build request to use BWS Badges solution */
const request = {
{
  "solution": "BWS.NFT.GameCube",
  "operation": "new_calendar",
  "parameters":  {
     "name": "2025-26"    
  }
}

/* call BWS API using Axios */
let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.bws.ninja/v1/call',
  headers: { 
    'X-Api-Key': 'XqaLg...... A5k2V729v', /* use your API key here! */
    'Content-Type': 'application/json'
  },
  data : JSON.stringify(request)
};

axios.request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

new_calendar Call Response

When the API call is successfully executed, it returns the calendarId, which will be used to link with related objects.

{
  "statusCode": 200,
  "info": {
      "calendarId": "8a7324f4-311d-43a8-a28f-87d9c424c354"
  }
}

list_calendars

POST https://api.bws.ninja/v1/call

Request Body

Name	Type	Description
solution*	string	BWS.NFT.GameCube
operation*	string	list_fields
parameters	JSON	(optional) check method parameters

list_calendars Method Parameters (optional)

Parameter	Type	Desciption
calendar_id	string	Calendar Id

list_calendars API Call Example

list_calendars API call using Node.js

const axios = require('axios');

/* build request to use BWS Badges solution */
const request = {
{
  "solution": "BWS.NFT.GameCube",
  "operation": "list_calendars",
  "parameters":  {
      "calendarId": "8a7324f4-311d-43a8-a28f-87d9c424c354"  
  }
}

/* call BWS API using Axios */
let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.bws.ninja/v1/call',
  headers: { 
    'X-Api-Key': 'XqaLg...... A5k2V729v', /* use your API key here! */
    'Content-Type': 'application/json'
  },
  data : JSON.stringify(request)
};

axios.request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

list_calendars Call Response

When the API call is successfully executed, it returns the list of calendars you created or a single calendar if the CalendarId parameter is included in the call.

{
  "statusCode": 200,
  "info": {
    "calendars": [
            {
                "calendarId": "8a7324f4-311d-43a8-a28f-87d9c424c354",
                "data": {
                    "name": "2025-26"
                }
            }
        ]
  }
}

delete_calendar

POST https://api.bws.ninja/v1/call

Request Body

Name	Type	Description
solution*	string	BWS.NFT.GameCube
operation*	string	delete_calendar
parameters*	JSON	check method parameters

delete_field Method Parameters

Parameter	Type	Desciption
calendarId	string	Then Calendar Id of the calendar to delete.

delete_calendar API Call Example

delete_calendar API call using Node.js

const axios = require('axios');

/* build request to use BWS Badges solution */
const request = {
{
  "solution": "BWS.NFT.GameCube",
  "operation": "delete_calendar",
  "parameters":  {
     "calendarId": "8a7324f4-311d-43a8-a28f-87d9c424c354"  
  }
}

/* call BWS API using Axios */
let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.bws.ninja/v1/call',
  headers: { 
    'X-Api-Key': 'XqaLg...... A5k2V729v', /* use your API key here! */
    'Content-Type': 'application/json'
  },
  data : JSON.stringify(request)
};

axios.request(config)
  .then((response) => {
    console.log(JSON.stringify(response.data));
  })
  .catch((error) => {
    console.log(error);
  });

delete_calendar Call Response

When the API call is executed without errors, it returns a successful status code.

{
  "statusCode": 200
}