Skip to content
GET /v1/match

Match detail (line-ups, scorers)

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/soccer-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/soccer-api/v1/match" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/soccer-api/v1/match", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/soccer-api/v1/match");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/soccer-api/v1/match",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "match": {
            "id": "740966",
            "name": "Brighton & Hove Albion vs Manchester United",
            "goals": [],
            "teams": [
                {
                    "id": "331",
                    "team": "Brighton & Hove Albion",
                    "score": "0",
                    "winner": false,
                    "home_away": "home"
                },
                {
                    "id": "360",
                    "team": "Manchester United",
                    "score": "3",
                    "winner": true,
                    "home_away": "away"
                }
            ],
            "venue": "American Express Stadium",
            "status": "Full Time",
            "lineups": [
                {
                    "team": "Brighton & Hove Albion",
                    "starters": [
                        "Bart Verbruggen",
                        "Lewis Dunk",
                        "Jan Paul van Hecke",
                        "Ferdi Kadioglu",
                        "Mats Wieffer",
                        "Jack Hinshelwood",
                        "James Milner",
                        "Pascal Gross",
                        "Danny Welbeck",
                        "Maxim De Cuyper",
                        "Diego Gómez"
                    ],
                    "formation": "4-2-3-1"
                },
                {
                    "team": "Manchester United",
                    "starters": [
                        "Senne Lammens",
                        "Lisandro Martínez",
                        "Harry Maguire",
                        "Luke Shaw",
                        "Noussair Mazraoui",
                        "Bruno Fernandes",
                        "Kobbie Mainoo",
                        "Mason Mount",
                        "Bryan Mbeumo",
                        "Patrick Dorgu",
                        "Amad"
                    ],
                    "formation": "4-2-3-1"
                }
            ]
        },
        "league": "eng.1"
    },
    "meta": {
        "timestamp": "2026-06-07T16:46:32.554Z",
        "request_id": "49633a52-e129-4f30-a3cf-9519852aaab2"
    },
    "status": "ok",
    "message": "Match retrieved successfully",
    "success": true
}