Head-to-Head - AnySport

Given two teams’ team1_id/team2_id, returns their last N historical meetings (default 10, adjustable), with a field structure identical to the fixtures list. Typically used for the “Head-to-Head” section of a pre-match analysis page, helping users quickly understand the two teams’ past record and recent trends.

Endpoint

GET /v1/soccer/head2head

Parameters

Parameter	Type	Required	Default	Description
`team1_id`	string	Yes		Team 1 (`ast_`)
`team2_id`	string	Yes		Team 2 (`ast_`)
`limit`	int	No	10	Return the last N matches (1–100)
`lang`	string	No	en	Target language (e.g. `zh-CN`); invalid values silently fall back to the default language — available values are authoritatively sourced from `GET /v1/soccer/languages`

Response fields (data: array)

Field	Type	Description
`match_id`	string	Match ID (`as_` prefix, consistent across all endpoints)
`date`	string	Kickoff date `YYYY-MM-DD` (UTC, ISO)
`time`	string	Kickoff time `HH:mm` (UTC)
`status`	string	Three forms — see “Enum reference” below for the complete list
`status_label`	string	Localized text for the match status; the original `status` value is unchanged, sent when `lang` is a non-default language and localized text exists for that textual status (`HH:MM`/plain numeric minute forms never have a label). Not every value has localized text; when there is no corresponding text this field is omitted, so clients must handle that gracefully
`league`	string	League name
`league_id`	string	League ID (`asl_`)
`season`	string	Season
`home`	object	Home team `{ name, team_id }`
`away`	object	Away team `{ name, team_id }`
`ht_score`	string	Half-time score (normalized to the `2-2` form, no spaces)
`ft_score`	string	Regular 90-minute score
`et_score`	string	Cumulative score at the end of extra time (not returned if there was no extra time)
`penalty_score`	string	Penalty shootout score (not returned if there wasn’t one)
`venue`	string	Venue

*_label convention: when lang is a non-default language (e.g. zh-CN), status retains its original value, and a parallel localized label status_label is added (only textual statuses can be localized). Not every value has localized text; when there is no corresponding text this field is omitted, so clients must handle that gracefully. Team names/league names (home/away/league) are not yet localized by lang.

Enum reference

The status field takes one of three forms: 1). Textual status:

Value	Meaning
`Not Started`	Not started: not yet begun
`TBA`	Not started: time to be announced
“ (empty string)	Not started: unscheduled/unmarked, treated as not started
`HT`	In progress: half-time break
`ET`	In progress: extra time in progress
`P`	In progress: penalty shootout in progress
`Break Time`	In progress: break between extra-time halves, or between extra time and the penalty shootout
`FT`	Finished: end of regulation time (Full Time, most common)
`AET`	Finished: ended after extra time (After Extra Time)
`Pen.`	Finished: decided by penalty shootout (Penalties)
`Awarded`	Finished: awarded loss/win (technical loss — forfeiture, eligibility issues, or other administrative rulings)
`WO`	Finished: forfeit/win by default (Walkover)
`Postp.`	Postponed: postponed
`Delayed`	Postponed: kickoff delayed
`Cancl.` / `Cancelled`	Cancelled
`Abandoned` / `Aban.`	Interrupted: match abandoned
`Susp.`	Interrupted: suspended (interrupted after kickoff)
`Int.`	Interrupted: interrupted

2). HH:MM form (e.g. 15:00, 19:45): not started, the value is the UTC kickoff time (matches the time field). 3). Plain numeric form (e.g. 9, 45, 88): in progress, the value is the current match minute.

Request example

GET /v1/soccer/head2head?team1_id=ast_9137ee449e3b40a68149ca319373adaf&team2_id=ast_13e4e7eccd7640de91c13cffcf0c3ff2&limit=5&lang=en

Response example

Head-to-head example: Argentina vs England (excerpt)

{
  "success": true,
  "data": [
    {
      "match_id": "as_794ea6e4273c488c8d2038832bed3059",
      "date": "1998-06-30",
      "time": "19:00",
      "status": "Pen.",
      "league": "World Cup",
      "league_id": "asl_62db9cfc3ebf4b87a44570b16668b23e",
      "season": "1998",
      "home": {
        "name": "Argentina",
        "team_id": "ast_9137ee449e3b40a68149ca319373adaf"
      },
      "away": {
        "name": "England",
        "team_id": "ast_13e4e7eccd7640de91c13cffcf0c3ff2"
      },
      "ht_score": "2-2",
      "ft_score": "2-2",
      "venue": "Stade Geoffroy-Guichard (Saint-Ètienne)"
    },
    {
      "match_id": "as_86b9a00a78ba4e1a8c60d01e4c9fdd96",
      "date": "1966-07-23",
      "time": "14:00",
      "status": "FT",
      "league": "World Cup",
      "league_id": "asl_62db9cfc3ebf4b87a44570b16668b23e",
      "season": "1966",
      "home": {
        "name": "England",
        "team_id": "ast_13e4e7eccd7640de91c13cffcf0c3ff2"
      },
      "away": {
        "name": "Argentina",
        "team_id": "ast_9137ee449e3b40a68149ca319373adaf"
      },
      "ht_score": "0-0",
      "ft_score": "1-0",
      "venue": "Wembley Stadium (old) (London)"
    }
  ],
  "meta": {
    "total": 5,
    "timestamp": "2026-07-13T19:18:24.654061Z"
  },
  "traceId": "d0128f3b-d0c1-4dd4-8f30-a74ed49048e2"
}

​Endpoint

​Parameters

​Response fields (data: array)

​Enum reference

​Request example

​Response example

Endpoint

Parameters

Response fields (data: array)

Enum reference

Request example

Response example