Skip to main content
POST
Get Fixtures

Request contract

  • Method and path: POST /apis/v1/api-sports/get-fixtures
  • Availability: enabled
  • Request URL template: https://api.aisa.one/apis/v1/api-sports/get-fixtures
  • 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
id
integer

Unique identifier of the fixture.

Required range: x >= 1
Example:

215662

to
string

End date for date range (YYYY-MM-DD).

Example:

"2020-06-30"

date
string

A valid date (YYYY-MM-DD).

Example:

"2020-05-30"

from
string

Start date for date range (YYYY-MM-DD).

Example:

"2020-05-30"

last
integer

Number of last fixtures to retrieve. Capped at ~20 fixtures; use league with from/to for extended range coverage.

Required range: 1 <= x <= 20
Example:

2

live
string

Get all live fixtures (all) or only those with events (all-events).

Example:

"all"

next
integer

Number of next fixtures to retrieve.

Required range: 1 <= x <= 20
Example:

2

team
integer

Unique identifier of the team.

Required range: x >= 1
Example:

33

round
string

Round of the fixture.

Example:

"Regular Season - 1"

venue
integer

Unique identifier of the venue.

Required range: x >= 1
Example:

556

league
integer

Unique identifier of the league.

Required range: x >= 1
Example:

39

season
integer

Season year (4-digit year).

Required range: 1000 <= x <= 9999
Example:

2019

status
string

Status of the fixture (NS, LIVE, FT, etc.).

Example:

"NS"

timezone
string

IANA timezone for date conversion. Set correctly to avoid empty results when filtering by date, live, or status, as all times default to UTC.

Example:

"Europe/London"

Response

Tool result data

get
string
required
errors
required
paging
object
required
results
integer
required
Required range: x >= 0
response
object[]
required
parameters
required