Check API status

A lightweight call that tells you whether the API is up. Point an uptime monitor or a deploy check at it.

curl "https://api.soccer-data.co/v1/health"

const res = await fetch("https://api.soccer-data.co/v1/health");
const { status } = await res.json();

import requests

status = requests.get("https://api.soccer-data.co/v1/health").json()["status"]

$status = Http::get('https://api.soccer-data.co/v1/health')->json('status');

{
    "status": "healthy",
    "timestamp": "2026-10-28T09:15:42Z"
}

### GET /health

Check API status

A lightweight call that tells you whether the API is up. Point an uptime monitor or a deploy check at it.
- It only says the service is running. To check that your key works, call a data endpoint such as /competitions instead.

Response fields:
- `status` (string): healthy when the API is answering normally.
- `timestamp` (string): The server's clock at the moment it answered, as an ISO 8601 date-time.

Example: curl "https://api.soccer-data.co/v1/health" -H "X-Api-Key: $SOCCER_DATA_KEY"