Worldreferee APIworldreferee.com ↗

Stay informed about upcoming football match officials by accessing confirmed referee assignments, home and away teams, competition details, and match dates directly from WorldReferee.com. Plan your coverage or analysis with real-time information on who's officiating your favorite matches.

This API takes change requests — .

Endpoint health

monitored

get_upcoming_appointments

Checks pendingself-healing

Endpoints

Updated

55m ago

This call costs1 credit / call— charged only on success

Try it

No input parameters required.

→ api.parse.bot/scraper/3b98e6fb-23e3-4498-bf1a-1f9c48148b04/<endpoint>

Ready to send

Fill in the parameters and hit sign in to send to see live response data here.

Call it over HTTPgrab a free API key at signup

curl -X GET 'https://api.parse.bot/scraper/3b98e6fb-23e3-4498-bf1a-1f9c48148b04/get_upcoming_appointments' \
  -H 'X-API-Key: $PARSE_API_KEY'

All endpoints · 1 totalmissing one? ·

Returns all upcoming football matches with their referee appointments listed on WorldReferee.com. Each match includes home team, away team, competition name, match date, and assigned referee (or 'TBA' if not yet announced). Results are grouped by competition and date on the source page; this endpoint flattens them into a single array. Typically returns 40-80 matches spanning the next 1-2 weeks across multiple leagues (La Liga, Bundesliga, Ligue 1, Serie A, Premier League, etc.). No pagination — one call returns all listed matches.

Input

No input parameters required.

Response

{
  "type": "object",
  "fields": {
    "total": "integer count of matches returned",
    "matches": "array of match objects with home_team, away_team, referee, competition, and date"
  },
  "sample": {
    "data": {
      "total": 60,
      "matches": [
        {
          "date": "Friday 28 August 2026",
          "referee": "TBA",
          "away_team": "Elche CF",
          "home_team": "Real Racing Club de Santander",
          "competition": "La Liga"
        },
        {
          "date": "Friday 28 August 2026",
          "referee": "TBA",
          "away_team": "VfB Stuttgart",
          "home_team": "FC Bayern München",
          "competition": "Bundesliga"
        }
      ]
    },
    "status": "success"
  }
}

About the Worldreferee API

The Worldreferee API on Parse exposes 1 endpoint for the publicly available data on worldreferee.com. Calls return JSON over HTTPS and are billed per successful response.

Pin a release with the API-Snapshot-Version header so canonical updates don't silently change your contract.