> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sportsapipro.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Futsal V2 API Overview

> Enhanced Futsal API: 101 endpoints for live scores, leagues, teams, players, and more

## Base URL

```
https://api.sportsapipro.com/v2/futsal
```

## Authentication

All requests require the `x-api-key` header:

```bash theme={null}
curl -H "x-api-key: YOUR_API_KEY" \
  https://api.sportsapipro.com/v2/futsal/live
```

## About Futsal

Futsal is 5-a-side indoor football played on a hard court with a smaller, low-bounce ball. The API covers **49 countries/categories** with approximately **181 matches per day** — one of the highest-volume sports on the platform.

### Key Rules

| Feature               | Detail                                                                            |
| --------------------- | --------------------------------------------------------------------------------- |
| **Players**           | 5 per side (4 outfield + 1 goalkeeper)                                            |
| **Match Duration**    | 2 × 20 minutes (stopped clock)                                                    |
| **Ball**              | Size 4 (low bounce)                                                               |
| **Substitutions**     | Unlimited (fly-on, fly-off)                                                       |
| **Accumulated Fouls** | After 5 team fouls per half → direct free kick from 10m (no wall)                 |
| **Power Play**        | Goalkeeper can be substituted for extra outfield player (5v4 attack)              |
| **4-Second Rule**     | Goalkeeper has 4 seconds to release; kick-ins/corners/free kicks within 4 seconds |
| **Offside**           | No offside rule in futsal                                                         |

### Positions

| Position    | Role                                               |
| ----------- | -------------------------------------------------- |
| **Goleiro** | Goalkeeper                                         |
| **Fixo**    | Defender (last outfield player)                    |
| **Ala**     | Winger (left and right)                            |
| **Pivô**    | Pivot / target player (closest to opponent's goal) |

### Key Statistics

Goals, assists, shots on/off target, fouls committed, accumulated fouls, saves, power play goals, yellow/red cards.

## Endpoint Categories

| Category                  | Count | Description                                  |
| ------------------------- | ----- | -------------------------------------------- |
| Live & Schedule           | 7     | Real-time scores and daily schedules         |
| Search & Discovery        | 7     | Search teams, players, tournaments           |
| Tournament / League       | 22    | League tables, standings, knockouts          |
| Match                     | 22    | Full match data, lineups, stats, odds        |
| Team                      | 12    | Squads, form, media                          |
| Player                    | 18    | Career stats, transfers, national team stats |
| Manager / Referee / Venue | 13    | Coaches, officials, arenas                   |

**Total: 101 endpoints**

## Major Leagues

* 🇪🇸 Spain — Primera División
* 🇧🇷 Brazil — Liga Nacional de Futsal
* 🇵🇹 Portugal — Liga Placard
* 🇷🇺 Russia — Super League
* 🌍 FIFA — Futsal World Cup

## Example Requests

<CodeGroup>
  ```bash cURL theme={null}
  curl -X GET "https://api.sportsapipro.com/v2/futsal/live" \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch(
    'https://api.sportsapipro.com/v2/futsal/live',
    { headers: { 'x-api-key': 'YOUR_API_KEY' } }
  );
  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      'https://api.sportsapipro.com/v2/futsal/live',
      headers={'x-api-key': 'YOUR_API_KEY'}
  )
  data = response.json()
  ```
</CodeGroup>

## UI Design Ideas

* **Score display**: Like football: "Barcelona 4-2 Inter Movistar" — goals are the scoring unit
* **Period scores**: Show 1st half and 2nd half separately (e.g., "2-1 / 2-1")
* **Accumulated fouls counter**: Display prominently — affects gameplay at 6th foul
* **Power play indicator**: Show "Power Play 5v4" when team pulls goalkeeper
* **Similar to football UI**: Reuse football patterns but adapt for 5v5 indoor format

## Sport Comparison — Futsal vs Football vs Basketball

| Feature          | Futsal                                 | Football (Soccer)   | Basketball           |
| ---------------- | -------------------------------------- | ------------------- | -------------------- |
| Players per side | 5 (4 outfield + 1 goalkeeper)          | 11                  | 5                    |
| Pitch            | Indoor court, 40×20m                   | Grass, 100-110m     | Indoor court, 28×15m |
| Match duration   | 2 × 20 min (stopped clock)             | 2 × 45 min          | 4 × 10/12 min        |
| Ball             | Size 4 (low bounce)                    | Size 5              | Size 7               |
| Scoring          | Goals (2-8 typical per team)           | Goals (0-5 typical) | Points (80-120)      |
| Substitutions    | Unlimited (fly-on fly-off)             | 3-5 (limited)       | Unlimited            |
| Fouls            | Accumulated fouls (6th foul = penalty) | Free kicks          | Personal fouls       |
| Key positions    | Goleiro, Fixo, Ala, Pivô               | GK, DEF, MID, FWD   | PG, SG, SF, PF, C    |