Skip to main content
POST
Reference example

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
Complete OpenAPI definition Effective request and pricing declaration (including authentication and referenced schemas):

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

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
h2h
string
required

Team IDs in 'ID-ID' format, e.g., '33-34'

Pattern: ^\d+-\d+$
Example:

"33-34"

to
string

End date for filtering (YYYY-MM-DD)

Example:

"2020-12-31"

date
string

Filter fixtures by a specific date in YYYY-MM-DD format

Example:

"2020-01-01"

from
string

Start date for filtering (YYYY-MM-DD)

Example:

"2020-01-01"

last
integer

Number of most recent past fixtures to retrieve

next
integer

Number of upcoming fixtures to retrieve

league
integer

League ID to filter fixtures

season
integer

Season year in YYYY format, e.g., 2020

status
string

Filter fixtures by status code, e.g., 'FT'

timezone
string

Specify IANA timezone, e.g., 'Europe/London'

Response

Tool result data

get
string
required
errors
required
paging
object
required
results
integer
required
response
object[]
required
parameters