Reference example
# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
--url https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"h2h": "33-34"
}'curl --request POST \
--url https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"h2h": "33-34"
}'import requests
url = "https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead"
payload = { "h2h": "33-34" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({h2h: '33-34'})
};
fetch('https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'h2h' => '33-34'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead"
payload := strings.NewReader("{\n \"h2h\": \"33-34\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"h2h\": \"33-34\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"h2h\": \"33-34\"\n}"
response = http.request(request)
puts response.read_body{
"get": "<string>",
"errors": [
"<string>"
],
"paging": {
"total": 123,
"current": 123
},
"results": 123,
"response": [
{
"goals": {
"away": 123,
"home": 123
},
"score": {
"penalty": {
"away": 123,
"home": 123
},
"fulltime": {
"away": 123,
"home": 123
},
"halftime": {
"away": 123,
"home": 123
},
"extratime": {
"away": 123,
"home": 123
}
},
"teams": {
"away": {
"id": 123,
"logo": "<string>",
"name": "<string>",
"winner": true
},
"home": {
"id": 123,
"logo": "<string>",
"name": "<string>",
"winner": true
}
},
"league": {
"id": 123,
"logo": "<string>",
"name": "<string>",
"round": "<string>",
"season": 123,
"country": "<string>",
"flag": "<string>",
"standings": true
},
"fixture": {
"id": 123,
"date": "<string>",
"venue": {
"id": 123,
"city": "<string>",
"name": "<string>"
},
"status": {
"long": "<string>",
"short": "<string>",
"extra": 123,
"elapsed": 123
},
"periods": {
"first": 123,
"second": 123
},
"timezone": "<string>",
"timestamp": 123,
"referee": "<string>"
}
}
],
"parameters": [
"<string>"
]
}API-Sports
Get Head-to-Head Fixtures
<!-- aisa-pricing:start -->
Usage-based billing; Default request estimate: $0.000384 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->
POST
https://api.aisa.one
/
apis
/
v1
/
api-sports
/
get-fixtures-headtohead
Reference example
# Fixed reference example. Playground inputs do not update this sample.
curl --request POST \
--url https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"h2h": "33-34"
}'curl --request POST \
--url https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"h2h": "33-34"
}'import requests
url = "https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead"
payload = { "h2h": "33-34" }
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({h2h: '33-34'})
};
fetch('https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'h2h' => '33-34'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead"
payload := strings.NewReader("{\n \"h2h\": \"33-34\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"h2h\": \"33-34\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"h2h\": \"33-34\"\n}"
response = http.request(request)
puts response.read_body{
"get": "<string>",
"errors": [
"<string>"
],
"paging": {
"total": 123,
"current": 123
},
"results": 123,
"response": [
{
"goals": {
"away": 123,
"home": 123
},
"score": {
"penalty": {
"away": 123,
"home": 123
},
"fulltime": {
"away": 123,
"home": 123
},
"halftime": {
"away": 123,
"home": 123
},
"extratime": {
"away": 123,
"home": 123
}
},
"teams": {
"away": {
"id": 123,
"logo": "<string>",
"name": "<string>",
"winner": true
},
"home": {
"id": 123,
"logo": "<string>",
"name": "<string>",
"winner": true
}
},
"league": {
"id": 123,
"logo": "<string>",
"name": "<string>",
"round": "<string>",
"season": 123,
"country": "<string>",
"flag": "<string>",
"standings": true
},
"fixture": {
"id": 123,
"date": "<string>",
"venue": {
"id": 123,
"city": "<string>",
"name": "<string>"
},
"status": {
"long": "<string>",
"short": "<string>",
"extra": 123,
"elapsed": 123
},
"periods": {
"first": 123,
"second": 123
},
"timezone": "<string>",
"timestamp": 123,
"referee": "<string>"
}
}
],
"parameters": [
"<string>"
]
}Request contract
- Method and path: POST /apis/v1/api-sports/get-fixtures-headtohead
- Availability: enabled
- Request URL template:
https://api.aisa.one/apis/v1/api-sports/get-fixtures-headtohead - Runtime facts: 79c3a316fdeba0e2a5966a14b3bd8b262de8099a119b3fcdb47de874db1aed3e
{
"operationId": "api-sports.get-fixtures-headtohead",
"method": "POST",
"path": "/apis/v1/api-sports/get-fixtures-headtohead",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [],
"security": [
{
"bearerAuth": []
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"required": [
"h2h"
],
"properties": {
"to": {
"type": "string",
"examples": [
"2020-12-31"
],
"description": "End date for filtering (YYYY-MM-DD)"
},
"h2h": {
"type": "string",
"pattern": "^\\d+-\\d+$",
"examples": [
"33-34"
],
"description": "Team IDs in 'ID-ID' format, e.g., '33-34'"
},
"date": {
"type": "string",
"examples": [
"2020-01-01"
],
"description": "Filter fixtures by a specific date in YYYY-MM-DD format"
},
"from": {
"type": "string",
"examples": [
"2020-01-01"
],
"description": "Start date for filtering (YYYY-MM-DD)"
},
"last": {
"type": "integer",
"description": "Number of most recent past fixtures to retrieve"
},
"next": {
"type": "integer",
"description": "Number of upcoming fixtures to retrieve"
},
"league": {
"type": "integer",
"description": "League ID to filter fixtures"
},
"season": {
"type": "integer",
"description": "Season year in YYYY format, e.g., 2020"
},
"status": {
"type": "string",
"description": "Filter fixtures by status code, e.g., 'FT'"
},
"timezone": {
"type": "string",
"description": "Specify IANA timezone, e.g., 'Europe/London'"
}
}
}
}
}
},
"x-aisa-status": "enabled",
"x-aisa-pricing": {
"cost_contract": "response_units",
"customer_multiplier": 1.0,
"customer_pricing": "provider_cost_multiplier",
"default_request_estimate_usd": 0.000384,
"estimate_source": "profile_seed",
"evidence_source": "response_body",
"maximum_units": 10000000,
"unit": "provider_credit",
"unit_rate_usd": 1e-06
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
Cost and request rules
Usage-based billing; Default request estimate: $0.000384 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.- Default request reference estimate (USD): 0.000384
- Declared unit rate (USD): 1e-06
- Billing unit: provider_credit
- Cost contract: response_units
- Published reference multiplier: 1.0
- Declared maximum count/units: 10000000
- Settlement evidence source: response_body
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Team IDs in 'ID-ID' format, e.g., '33-34'
Pattern:
^\d+-\d+$Example:
"33-34"
End date for filtering (YYYY-MM-DD)
Example:
"2020-12-31"
Filter fixtures by a specific date in YYYY-MM-DD format
Example:
"2020-01-01"
Start date for filtering (YYYY-MM-DD)
Example:
"2020-01-01"
Number of most recent past fixtures to retrieve
Number of upcoming fixtures to retrieve
League ID to filter fixtures
Season year in YYYY format, e.g., 2020
Filter fixtures by status code, e.g., 'FT'
Specify IANA timezone, e.g., 'Europe/London'