Flexyscore

API 1.0 Documentation & Manual

* Important preliminary note:

The Flexyscore API and console can work simultaneously. If your source fails, simply refresh the console page to read the latest data received and continue scoring via the console itself.

Flexyscore API access is included in the "Pro" plans. Request a free quote detailing your needs.

How to start:

Login into your Flexyscore account at live.flexyscore.net
Create a new Scoreboard, insert team names, and confirm to access ti the match controller.
By clicking the "Copy API Token" button get the scoreboard token.

Copy API token button — In the controller footer you can find the "Copy API token" button

Build your callout:

Endpoint: https://www.live.flexyscore.net/dirette/in_dispatchers/apidispatcher.php
Method: POST
Header: 'Content-Type': 'application/x-www-form-urlencoded'
Payload: see the tables below

Mandatory callout:

Name	Data Type	Description / Value
liveid	string	API Token (copied by button into console)

Optional callouts:
*when not sent Flexyscore keeps the default value

SELECT Board
GENERIC
BASKET
HOCKEY
TENNIS
PINGPONG
RUGBY
SOCCER
VOLLEY
FOOTBALL
BASEBALL
HANDBALL
BOXE

Generic scoreboard collouts

Name	Data Type	Description / Value
team_1	string	Home team name / text
team_2	string	Away team name / text
points_1	int	Home team points / number
points_2	int	Away team points/ number

Name	Data Type	Description / Value
team_1	string	Home player name / text
team_2	string	Away player name / text
color_1	string	Home player color / hex '#FF0000' or name 'red' or rgb 'rgb(255, 0, 0)'
color_2	string	Away player color / hex '#0000FF' or name 'blue' or rgb 'rgb(0, 0, 255)'
moment	int	Round number / number
calendar	int	Match number (if set to 0 [Zero] the "Match" label disappear) / number
timer	int	this set the starting time of the round, you can also use it for adjust the timer / number (in seconds; 180 = 3:00)
user_signal	int	start/stop timer / 1 start, 0 stop

Generic board snippet example


<!DOCTYPE html>
<html>
<head>
    <title>Test API Dispatcher GENERIC board</title>
</head>
<body>
    <h2>API testing in progress... look at the console</h2>
    <script>
        // Endpoint URL
        const endpoint = 'https://www.live.flexyscore.net/dirette/in_dispatchers/apidispatcher.php';

        // Token liveid (replace the token below with a real and valid one)
        const liveidToken = 'zzJ4+IT63Xck0cMOX8GYuw==|qD6rqwIvHRTCyhN9Ldje9g==';

        // DATA (name: 'value')
        const baseData = {
            liveid: liveidToken,
            team_1: 'Tappa',
            team_2: 'Rappa',
        };

        // In this example, for testing purposes only, random data is sent every 3 seconds.
        setInterval(() => {
            const points_1 = Math.floor(Math.random() * 100);
            const points_2 = Math.floor(Math.random() * 100);

            const payload = {
                ...baseData,
                points_1,
                points_2,
            };

            fetch(endpoint, {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/x-www-form-urlencoded',
                },
                body: new URLSearchParams(payload).toString(),
            })
            .then(response => response.json())
            .then(data => {
                console.log('API Response:', data);
            })
            .catch(error => {
                console.error('API response error:', error);
            });
        }, 3000);
    </script>
</body>
</html>

Basketball board snippet example


<!DOCTYPE html>
<html>
<head>
    <title>Test API Dispatcher BASKETBALL board</title>
</head>
<body>
    <h2>API testing in progress... look at the console</h2>
    <script>
        // Endpoint URL
        const endpoint = 'https://www.live.flexyscore.net/dirette/in_dispatchers/apidispatcher.php';

        // Token liveid (replace the token below with a real and valid one)
        const liveidToken = '81/4IC2nf7TDBnuHsZxm5Q==|d5uzmDAgP6v/pKH3kdsZQQ==';

        // DATA (name: 'value')
        const baseData = {
            liveid: liveidToken,
            team_1: 'Tappa',
            team_2: 'Rappa',
            overtime: 1,
            bonus_1: 0,
            bonus_2: 1,
            generictoggle: 0,
            timer: 600,
            user_signal: 1
        };

        // In below lines, for testing purposes only, random data is sent every 3 seconds.
        setInterval(() => {
            const points_1 = Math.floor(Math.random() * 100);
            const points_2 = Math.floor(Math.random() * 100);
            const timeouts_1 = Math.floor(Math.random() * 50);
            const timeouts_2 = Math.floor(Math.random() * 50);
            const fouls_1 = Math.floor(Math.random() * 30);
            const fouls_2 = Math.floor(Math.random() * 30);
            const moment = Math.floor(Math.random() * 10);

            const payload = {
                ...baseData,
                points_1,
                points_2,
                timeouts_1,
                timeouts_2,
                fouls_1,
                fouls_2,
                moment,
            };

            fetch(endpoint, {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/x-www-form-urlencoded',
                },
                body: new URLSearchParams(payload).toString(),
            })
            .then(response => response.json())
            .then(data => {
                console.log('API Response:', data);
            })
            .catch(error => {
                console.error('API response error:', error);
            });
        }, 3000);
    </script>
</body>
</html>

Hockey board snippet example


<!DOCTYPE html>
<html>
<head>
    <title>Test API Dispatcher GENERIC board</title>
</head>
<body>
    <h2>API testing in progress... look at the console</h2>
    <script>
        // Endpoint URL
        const endpoint = 'https://www.live.flexyscore.net/dirette/in_dispatchers/apidispatcher.php';

        // Token liveid (replace the token below with a real and valid one)
        const liveidToken = 'Vj4Ch7KW+V9aEk/rVlS9tg==|VqWnPIAzwVcR0Ed/XUhNBw==';

        // DATA (name: 'value')
        const baseData = {
            liveid: liveidToken,
            team_1: 'Tappa',
            team_2: 'Rappa',
            overtime: 1,
            timer: 1200,
            user_signal: 1
        };

        // In this example, for testing purposes only, random data is sent every 3 seconds.
        setInterval(() => {
            const points_1 = Math.floor(Math.random() * 100);
            const points_2 = Math.floor(Math.random() * 100);
            const moment = Math.floor(Math.random() * 10);

            const payload = {
                ...baseData,
                points_1,
                points_2,
                moment
            };

            fetch(endpoint, {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/x-www-form-urlencoded',
                },
                body: new URLSearchParams(payload).toString(),
            })
            .then(response => response.json())
            .then(data => {
                console.log('API Response:', data);
            })
            .catch(error => {
                console.error('API response error:', error);
            });
        }, 3000);
    </script>
</body>
</html>

Tennis board snippet example


<!DOCTYPE html>
<html>
<head>
    <title>Test API Dispatcher TENNIS board</title>
</head>
<body>
    <h2>API testing in progress... look at the console</h2>
    <script>
        // Endpoint URL
        const endpoint = 'https://www.live.flexyscore.net/dirette/in_dispatchers/apidispatcher.php';

        // Token liveid (replace the token below with a real and valid one)
        const liveidToken = '0liesX7Jal4sobVtDaoa5w==|7MfB5qqdclUTTYUknTxJ7w==';

        // DATA (name: 'value')
        const baseData = {
            liveid: liveidToken,
            team_1: 'Sinner',
            team_2: 'Alcaraz',
            set_1_points_1: 6,
            set_1_points_2: 0,
            set_1_on: 1,
            set_2_points_1: 3,
            set_2_points_2: 6,
            set_2_on: 1,
            set_3_points_1: 6,
            set_3_points_2: 2,
            set_3_on: 1,
            set_4_points_1: 0,
            set_4_points_2: 0,
            set_4_on: 0,
            set_5_points_1: 0,
            set_5_points_2: 0,
            set_5_on: 0,
            serv: 1,
        };

        // In this example, for testing purposes only, random data is sent every 3 seconds.
        setInterval(() => {
            const points_1 = Math.floor(Math.random() * 100);
            const points_2 = Math.floor(Math.random() * 100);
            const game_1 = Math.floor(Math.random() * 6);
            const game_2 = Math.floor(Math.random() * 6);

            const payload = {
                ...baseData,
                points_1,
                points_2,
                game_1,
                game_2,
            };

            fetch(endpoint, {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/x-www-form-urlencoded',
                },
                body: new URLSearchParams(payload).toString(),
            })
            .then(response => response.json())
            .then(data => {
                console.log('API Response:', data);
            })
            .catch(error => {
                console.error('API response error:', error);
            });
        }, 3000);
    </script>
</body>
</html>

Pingpong board snippet example


<!DOCTYPE html>
<html>
<head>
    <title>Test API Dispatcher PING PONG board</title>
</head>
<body>
    <h2>API testing in progress... look at the console</h2>
    <script>
        // Endpoint URL
        const endpoint = 'https://www.live.flexyscore.net/dirette/in_dispatchers/apidispatcher.php';

        // Token liveid (replace the token below with a real and valid one)
        const liveidToken = 'AqeJRKeaySD4i2CdEUNaxg==|TI7JH1Zd5K1nYtCGecvxyA==';

        // DATA (name: 'value')
        const baseData = {
            liveid: liveidToken,
            team_1: 'Mini Sinner',
            team_2: 'Mini Alcaraz',
            serv: 1,
        };

        // In this example, for testing purposes only, random data is sent every 3 seconds.
        setInterval(() => {
            const points_1 = Math.floor(Math.random() * 100);
            const points_2 = Math.floor(Math.random() * 100);
            const set_1 = Math.floor(Math.random() * 3);
            const set_2 = Math.floor(Math.random() * 3);

            const payload = {
                ...baseData,
                points_1,
                points_2,
                set_1,
                set_2,
            };

            fetch(endpoint, {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/x-www-form-urlencoded',
                },
                body: new URLSearchParams(payload).toString(),
            })
            .then(response => response.json())
            .then(data => {
                console.log('API Response:', data);
            })
            .catch(error => {
                console.error('API response error:', error);
            });
        }, 3000);
    </script>
</body>
</html>

Rugby board snippet example


<!DOCTYPE html>
<html>
<head>
    <title>Test API Dispatcher RUGBY board</title>
</head>
<body>
    <h2>API testing in progress... look at the console</h2>
    <script>
        // Endpoint URL
        const endpoint = 'https://www.live.flexyscore.net/dirette/in_dispatchers/apidispatcher.php';

        // Token liveid (replace the token below with a real and valid one)
        const liveidToken = 'okfflYbDlG5h9/qDVDAI6Q==|E0M6pZWRfASOIwD0ktSKdg==';

        // DATA (name: 'value')
        const baseData = {
            liveid: liveidToken,
            team_1: 'Red Home team',
            team_2: 'Blue Away team',
            timer: '0',
            user_signal: '1',
            overtime: '1',
        };

        // In this example, for testing purposes only, random data is sent every 3 seconds.
        setInterval(() => {
            const points_1 = Math.floor(Math.random() * 100);
            const points_2 = Math.floor(Math.random() * 100);
            const moment = Math.floor(Math.random() * 4);

            const payload = {
                ...baseData,
                points_1,
                points_2,
                moment,
            };

            fetch(endpoint, {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/x-www-form-urlencoded',
                },
                body: new URLSearchParams(payload).toString(),
            })
            .then(response => response.json())
            .then(data => {
                console.log('API Response:', data);
            })
            .catch(error => {
                console.error('API response error:', error);
            });
        }, 3000);
    </script>
</body>
</html>

Soccer board snippet example


<!DOCTYPE html>
<html>
<head>
    <title>Test API Dispatcher SOCCER board</title>
</head>
<body>
    <h2>API testing in progress... look at the console</h2>
    <script>
        // Endpoint URL
        const endpoint = 'https://www.live.flexyscore.net/dirette/in_dispatchers/apidispatcher.php';

        // Token liveid (replace the token below with a real and valid one)
        const liveidToken = 'okfflYbDlG5h9/qDVDAI6Q==|E0M6pZWRfASOIwD0ktSKdg==';

        // DATA (name: 'value')
        const baseData = {
            liveid: liveidToken,
            team_1: 'Red Home team',
            team_2: 'Blue Away team',
            timer: '0',
            user_signal: '1',
            overtime: '1',
        };

        // In this example, for testing purposes only, random data is sent every 3 seconds.
        setInterval(() => {
            const points_1 = Math.floor(Math.random() * 100);
            const points_2 = Math.floor(Math.random() * 100);
            const moment = Math.floor(Math.random() * 4);

            const payload = {
                ...baseData,
                points_1,
                points_2,
                moment,
            };

            fetch(endpoint, {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/x-www-form-urlencoded',
                },
                body: new URLSearchParams(payload).toString(),
            })
            .then(response => response.json())
            .then(data => {
                console.log('API Response:', data);
            })
            .catch(error => {
                console.error('API response error:', error);
            });
        }, 3000);
    </script>
</body>
</html>

Volley board snippet example


<!DOCTYPE html>
<html>
<head>
    <title>Test API Dispatcher VOLLEY board</title>
</head>
<body>
    <h2>API testing in progress... look at the console</h2>
    <script>
        // Endpoint URL
        const endpoint = 'https://www.live.flexyscore.net/dirette/in_dispatchers/apidispatcher.php';

        // Token liveid (replace the token below with a real and valid one)
        const liveidToken = 'AqeJRKeaySD4i2CdEUNaxg==|TI7JH1Zd5K1nYtCGecvxyA==';

        // DATA (name: 'value')
        const baseData = {
            liveid: liveidToken,
            team_1: 'Imoco Conegliano',
            team_2: 'UYBA Busto',
            serv: '1',
            generictoggle: '1',
        };

        // In this example, for testing purposes only, random data is sent every 3 seconds.
        setInterval(() => {
            const points_1 = Math.floor(Math.random() * 100);
            const points_2 = Math.floor(Math.random() * 100);
            const set_1 = Math.floor(Math.random() * 3);
            const set_2 = Math.floor(Math.random() * 3);

            const payload = {
                ...baseData,
                points_1,
                points_2,
                set_1,
                set_2,
            };

            fetch(endpoint, {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/x-www-form-urlencoded',
                },
                body: new URLSearchParams(payload).toString(),
            })
            .then(response => response.json())
            .then(data => {
                console.log('API Response:', data);
            })
            .catch(error => {
                console.error('API response error:', error);
            });
        }, 3000);
    </script>
</body>
</html>

Football board snippet example


<!DOCTYPE html>
<html>
<head>
    <title>Test API Dispatcher FOOTBALL board</title>
</head>
<body>
    <h2>API testing in progress... look at the console</h2>
    <script>
        // Endpoint URL
        const endpoint = 'https://www.live.flexyscore.net/dirette/in_dispatchers/apidispatcher.php';

        // Token liveid (replace the token below with a real and valid one)
        const liveidToken = 'NviOM2P9GZUQUPkRrCiuUw==|ExknXcQzuCqckxf8cw0VuQ==';

        // DATA (name: 'value')
        const baseData = {
            liveid: liveidToken,
            team_1: 'Yellow Home team',
            team_2: 'Brown Away team',
            timer: '900',
            user_signal: '1',
            overtime: '1',
        };

        // In this example, for testing purposes only, random data is sent every 3 seconds.
        setInterval(() => {
            const points_1 = Math.floor(Math.random() * 100);
            const points_2 = Math.floor(Math.random() * 100);
            const moment = Math.floor(Math.random() * 4);
            const timeouts_1 = Math.floor(Math.random() * 3);
            const timeouts_2 = Math.floor(Math.random() * 3);
            const yards = Math.floor(Math.random() * 120);
            const attempts = Math.floor(Math.random() * 120);
			const foul_signal = 1;

            const payload = {
                ...baseData,
                points_1,
                points_2,
                moment,
                timeouts_1,
                timeouts_2,
                yards,
                attempts,
				foul_signal,
            };

            fetch(endpoint, {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/x-www-form-urlencoded',
                },
                body: new URLSearchParams(payload).toString(),
            })
            .then(response => response.json())
            .then(data => {
                console.log('API Response:', data);
            })
            .catch(error => {
                console.error('API response error:', error);
            });
        }, 3000);
    </script>
</body>
</html>

Baseball board snippet example


<!DOCTYPE html>
<html>
<head>
    <title>Test API Dispatcher BASEBALL board</title>
</head>
<body>
    <h2>API testing in progress... look at the console</h2>
    <script>
        // Endpoint URL
        const endpoint = 'https://www.live.flexyscore.net/dirette/in_dispatchers/apidispatcher.php';

        // Token liveid (replace the token below with a real and valid one)
        const liveidToken = 'Sqp6nh8Gnh4YdMEzEuKZ/w==|fej2Qqv+17cQgGXrcNmuEA==';

        // DATA (name: 'value')
        const baseData = {
            liveid: liveidToken,
            team_1: 'Yellow team',
            team_2: 'Brown team',
            base_1: '1',
            base_2: '0',
            base_3: '1',
            serv: '1',
        };

        // In this example, for testing purposes only, random data is sent every 3 seconds.
        setInterval(() => {
            const points_1 = Math.floor(Math.random() * 100);
            const points_2 = Math.floor(Math.random() * 100);
            const innings = Math.floor(Math.random() * 4);
            const balls = Math.floor(Math.random() * 3);
            const strikes = Math.floor(Math.random() * 3);
            const outs = Math.floor(Math.random() * 3);

            const payload = {
                ...baseData,
                points_1,
                points_2,
                innings,
                balls,
                strikes,
                outs,
            };

            fetch(endpoint, {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/x-www-form-urlencoded',
                },
                body: new URLSearchParams(payload).toString(),
            })
            .then(response => response.json())
            .then(data => {
                console.log('API Response:', data);
            })
            .catch(error => {
                console.error('API response error:', error);
            });
        }, 3000);
    </script>
</body>
</html>

Handball board snippet example


<!DOCTYPE html>
<html>
<head>
    <title>Test API Dispatcher HANDBALL board</title>
</head>
<body>
    <h2>API testing in progress... look at the console</h2>
    <script>
        // Endpoint URL
        const endpoint = 'https://www.live.flexyscore.net/dirette/in_dispatchers/apidispatcher.php';

        // Token liveid (replace the token below with a real and valid one)
        const liveidToken = 'okfflYbDlG5h9/qDVDAI6Q==|E0M6pZWRfASOIwD0ktSKdg==';

        // DATA (name: 'value')
        const baseData = {
            liveid: liveidToken,
            team_1: 'Red Home team',
            team_2: 'Blue Away team',
            timer: '0',
            user_signal: '1',
            overtime: '1',
        };

        // In this example, for testing purposes only, random data is sent every 3 seconds.
        setInterval(() => {
            const points_1 = Math.floor(Math.random() * 100);
            const points_2 = Math.floor(Math.random() * 100);
            const moment = Math.floor(Math.random() * 4);

            const payload = {
                ...baseData,
                points_1,
                points_2,
                moment,
            };

            fetch(endpoint, {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/x-www-form-urlencoded',
                },
                body: new URLSearchParams(payload).toString(),
            })
            .then(response => response.json())
            .then(data => {
                console.log('API Response:', data);
            })
            .catch(error => {
                console.error('API response error:', error);
            });
        }, 3000);
    </script>
</body>
</html>

Boxe board snippet example


<!DOCTYPE html>
<html>
<head>
    <title>Test API Dispatcher BASEBALL board</title>
</head>
<body>
    <h2>API testing in progress... look at the console</h2>
    <script>
        // Endpoint URL
        const endpoint = 'https://www.live.flexyscore.net/dirette/in_dispatchers/apidispatcher.php';

        // Token liveid (replace the token below with a real and valid one)
        const liveidToken = 'oWa/kmWOo8wtImtd1SmxQQ==|TAtCpdtKiXrhjQ6oVGyR/A==';

        // DATA (name: 'value')
        const baseData = {
            liveid: liveidToken,
            team_1: 'Primo Carnera',
            team_2: 'Joe Lewis',
            timer: '120',
            user_signal: '1',
            color_1: 'orange',
            color_2: 'purple',
        };

        // In this example, for testing purposes only, random data is sent every 3 seconds.
        setInterval(() => {
            const moment = Math.floor(Math.random() * 10);
            const calendar = Math.floor(Math.random() * 3);
            
            const payload = {
                ...baseData,
                moment,
                calendar,
            };

            fetch(endpoint, {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/x-www-form-urlencoded',
                },
                body: new URLSearchParams(payload).toString(),
            })
            .then(response => response.json())
            .then(data => {
                console.log('API Response:', data);
            })
            .catch(error => {
                console.error('API response error:', error);
            });
        }, 3000);
    </script>
</body>
</html>

Flexyscore

API 1.0 Documentation & Manual

Generic scoreboard collouts

Basketball scoreboard collouts

Hockey scoreboard collouts

Tennis scoreboard collouts

Pingpong scoreboard collouts

Rugby scoreboard collouts

Soccer scoreboard collouts

Volley scoreboard collouts

Football scoreboard collouts

Baseball scoreboard collouts

Handball scoreboard collouts

Boxe scoreboard collouts