# history
## View team history matches ⬜ 🟨 🟦 🟩
`GET` `https://api.soccerfootball.info/v1/teams/history/?i=ID`
This endpoint returns with team data and its history matches. \
With parameter **`w`** you can define the time lapse "all" (from 2017 01 01), "1y" last year, "6m" last 6 months. \
The parameter **`l`** must be a language code getted from languages/list endpoint. Some elements such as championship and team names can be translated.\
Format response can be "json" or "csv" (Default "json")
#### Query Parameters
| Name | Type | Description |
| ---- | ------ | -------------------------------------------------------------- |
| t | string | Your API Token **`DIRECT API ONLY`** |
| f | string | Format response can be "json" or "csv" (default "json") |
| i | string | Team ID |
| w | string | When get time can be "all", "1y", "6m" (default value is "6m") |
| l | string | Language code (default value is "en\_US") |
#### Headers
| Name | Type | Description |
| --------------- | ------ | --------------------------------------------------- |
| X-RapidAPI-Key | string | Your API token **`RAPIDAPI ONLY`** |
| X-RapidAPI-Host | string | soccerfootballinfo.rapidapi.com **`RAPIDAPI ONLY`** |
{% tabs %}
{% tab title="200 Success response" %}
{% tabs %}
{% tab title="JSON" %}
```javascript
{
"status":200,
"errors":[],
"pagination":[],
"result":[
{
"lapse":"6m",
"results":{
"win":28, // number of win in lapse
"loss":2, // number of loss in lapse
"draw":7 // number of draw in lapse
},
"macthes":[
{
"id":"5ff1096066d98235",
"date":"2021-01-09 19:45:00",
"championship":{
"id":"5fda5fab11fbd288",
"name":"Italy Serie A",
"s_name":"Serie A 20/21"
},
"teamA":{
"id":"5fda5fcad92584cd",
"name":"AC Milan",
"score":"2",
"1h_score": "1"
},
"teamB":{
"id":"5fda5fc4a7cbddf2",
"name":"Torino",
"score":"0",
"1h_score": "0"
}
},
...
]
}
]
}
```
{% endtab %}
{% tab title="CSV" %}
```
time_6m;match_id;date_match;champipship;championship_id;season_name;teamA_name;teamA_id;teamA_score;teamA_1h_score;teamB_name;teamB_id;teamB_score;teamB_1h_score;result
;600772c53a14d889;"2021-01-26 19:45:00";"Coppa Italia";5fda5fa8d5514fc8;;"Inter Milan";5fda6034be4e9d6b;2;1;"AC Milan";5fda5fcad92584cd;1;1;LOSS
...
```
{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}
{% file src="/files/XJTQH8tCM5ZJYoj0jBag" %}
## Example of code for direct API
{% tabs %}
{% tab title="PHP" %}
```php
$url = 'https://api.soccerfootball.info/v1/teams/history/?t=TOKEN&i=ID';
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => $url,
CURLOPT_PROXY => null,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_CUSTOMREQUEST => "GET"
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if (!$err) {
$result = json_decode($response);
print_r($result);
} else {
echo "cURL Error:" . $err;
}
```
{% endtab %}
{% tab title="Javascript" %}
```python
fetch("https://api.soccerfootball.info/v1/teams/history/?t=TOKEN&i=ID", {
"method": "GET"
})
.then(response => {
console.log(response);
})
.catch(err => {
console.error(err);
});
```
{% endtab %}
{% tab title="NodeJS" %}
```javascript
const request = require('request');
const options = {
method: 'GET',
url: 'https://api.soccerfootball.info/v1/teams/history/?t=TOKEN&i=ID'
};
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
```
{% endtab %}
{% tab title="Phyton" %}
```python
import requests
url = "https://api.soccerfootball.info/v1/teams/history/?t=TOKEN&i=ID"
response = requests.get(url).json()
print(response)
```
{% endtab %}
{% tab title="cURL" %}
```bash
curl --request GET \
--url 'https://api.soccerfootball.info/v1/teams/history/?t=TOKEN&i=ID'
```
{% endtab %}
{% tab title="GO" %}
```go
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://api.soccerfootball.info/v1/teams/history/?t=TOKEN&i=ID"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
```
{% endtab %}
{% endtabs %}
## Example of code for RapidAPI
{% tabs %}
{% tab title="PHP" %}
```php
$url = 'https://soccer-football-info.p.rapidapi.com/teams/history/?i=ID';
$curl = curl_init();
curl_setopt_array($curl, array(
CURLOPT_URL => $url,
CURLOPT_PROXY => null,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_FOLLOWLOCATION => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-RapidAPI-Host: soccer-football-info.p.rapidapi.com",
"X-RapidAPI-Key: TOKEN"
],
));
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if (!$err) {
$result = json_decode($response);
print_r($result);
} else {
echo "cURL Error:" . $err;
}
```
{% endtab %}
{% tab title="Javascript" %}
```javascript
fetch("https://soccer-football-info.p.rapidapi.com/teams/history/?i=ID", {
"method": "GET",
"headers": {
"X-RapidAPI-Key": "TOKEN",
"X-RapidAPI-Host": "soccer-football-info.p.rapidapi.com"
}
})
.then(response => {
console.log(response);
})
.catch(err => {
console.error(err);
});
```
{% endtab %}
{% tab title="NodeJS" %}
```javascript
const request = require('request');
const options = {
method: 'GET',
url: "https://soccer-football-info.p.rapidapi.com/teams/history/?i=ID",
headers: {
"X-RapidAPI-Key": "TOKEN",
"X-RapidAPI-Host": "soccer-football-info.p.rapidapi.com"
useQueryString: true
}
};
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
```
{% endtab %}
{% tab title="Phyton" %}
```python
import requests
url = "https://soccer-football-info.p.rapidapi.com/teams/history/?i=ID"
headers = {
"X-RapidAPI-Key": "TOKEN",
"X-RapidAPI-Host": "soccer-football-info.p.rapidapi.com"
}
response = requests.request("GET", url, headers=headers)
print(response.text)
```
{% endtab %}
{% tab title="cURL" %}
```bash
curl --request GET \
--url https://soccer-football-info.p.rapidapi.com/teams/history/?i=ID \
--header 'X-RapidAPI-Host: soccer-football-info.p.rapidapi.com' \
--header 'X-RapidAPI-Key: TOKEN'
```
{% endtab %}
{% tab title="GO" %}
```go
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://soccer-football-info.p.rapidapi.com/teams/history/?i=ID"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-RapidAPI-Key", "TOKEN")
req.Header.Add("X-RapidAPI-Host", "soccer-football-info.p.rapidapi.com")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
```
{% endtab %}
{% endtabs %}
More example of code on [rapidAPI](https://rapidapi.com/soccerfootball-info-soccerfootball-info-default/api/soccer-football-)
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://info.soccerfootball.info/v1/teams/history.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.