Base URL and authentication
Base URL: https://cdesporte.com
Include your key with every request:
X-API-Key: YOUR_KEY
Available endpoints
Returns football matches with competition and team names localized in Portuguese. The default query uses the current UTC date.
| Parameter | Description |
|---|---|
date | One date in YYYY-MM-DD format. |
from and to | An inclusive range of up to seven dates. Both are required when used. |
status | scheduled, live, or finished. |
league | The competition ID or exact canonical name. |
page | Page number starting at 1. Default: 1. |
pageSize | From 1 to 100. Default: 50. |
Example using the current UTC date:
curl -s \ -H "X-API-Key: YOUR_KEY" \ "https://cdesporte.com/api/v1/matches"
Returns only football leagues with at least one eligible match inside the requested UTC window. Without date parameters, the query uses the current UTC date.
| Parameter | Description |
|---|---|
date | One date in YYYY-MM-DD format. It cannot be combined with from or to. |
from and to | An inclusive UTC range of up to seven dates. Both are required, must be ordered, and cannot exceed seven dates. |
country | An exact canonical or Portuguese name, such as Brazil or Brasil. Unknown values return an empty list. |
page | Page number starting at 1. Default: 1. |
pageSize | From 1 to 100. Default: 50. |
Example using the current UTC window:
curl -s \ -H "X-API-Key: YOUR_KEY" \ "https://cdesporte.com/api/v1/leagues"
The response uses Portuguese field names and sorts leagues by their localized name. pais and logo may be null when no value is available.
{
"geradoEm": "2026-07-28T12:34:56.000Z",
"pagina": 1,
"itensPorPagina": 50,
"total": 1,
"ligas": [
{
"id": "ddc42cb9-6222-4689-a673-581ed159a061",
"nome": "Brasil - Série A",
"pais": "Brasil",
"logo": "https://img.cdesporte.com/..."
}
]
}Response
{
"geradoEm": "2026-07-28T12:34:56.000Z",
"pagina": 1,
"itensPorPagina": 50,
"total": 1,
"partidas": [
{
"id": "7d44ef88-b4fc-4f2e-8d91-79c523d64101",
"competicao": {
"id": "f0324146-a642-4247-8cc0-8d0ef1224ad3",
"nome": "Campeonato Brasileiro Série A"
},
"timeCasa": {
"nome": "Flamengo",
"escudo": "https://img.cdesporte.com/..."
},
"timeVisitante": {
"nome": "Palmeiras",
"escudo": "https://img.cdesporte.com/..."
},
"inicio": "2026-07-28T23:30:00.000Z",
"status": "agendada",
"placar": null,
"minuto": null
}
]
}geradoEm is the UTC time when the response was generated. placar is null when no score exists. minuto is always present: it is an integer when a trustworthy live clock is available, and otherwise null.
Status values
agendada: not startedao_vivo: in progressencerrada: finishedadiada: postponedcancelada: cancelled
Errors
400 | Invalid or conflicting query parameters. |
401 | Missing or invalid API key. |
404 | API route not found. |
500 | Service temporarily unavailable. |