The free key reads yesterday again: our one-month trial of today on the free key has finished. Read the changelog

Absences

A
GET /v1/matches/{id}/absences

Players out or doubtful for one match: injuries and suspensions

Every player listed as missing one match, for both sides: out when he will not play, doubtful when he may not, with the reason (an injury, a suspension, illness and so on). Each carries the player_id used everywhere else, so a club's absences can be set beside its results. Held from 2021 where the competition publishes them, and refreshed in the days before each match.

Plan

This endpoint needs Archive. Calling it on a lower plan returns a 403 naming the plan it needs and a link to pricing, never a bare refusal.

Parameters

match_id string path required
The match id. Stable across re-imports: what you store today still resolves later. e.g. mt_1JK5QJ9

Returns

meta.data_as_of string
When the data behind this answer was last brought up to date.
meta.request_id string
This request's id, to quote to support.

Request

curl "https://api.footballsoccerapi.com/v1/matches/mt_1JK5QJ9/absences" \
  -H "X-API-Key: $FSAPI_KEY"

Example response

A real row from the archive, fetched when this page rendered. Run it against your own key below.

200 OK application/json
{
    "data": [],
    "meta": {
        "data_as_of": "2026-10-29T04:32:57Z",
        "request_id": "01J9QW3C7M4KX2VB"
    }
}

Run it live

Paste your key and fire the real request. The key is kept in this browser only and never sent anywhere but the API.

Get a key
GET