> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative.
> - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key.
> - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste.
> - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`.
> - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt

# Get fixture statistics

> <!-- 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 -->

## Request contract

* **Method and path:** POST /apis/v1/api-sports/get-fixtures-statistics
* **Availability:** enabled
* **Request URL template:** `https://api.aisa.one/apis/v1/api-sports/get-fixtures-statistics`
* **Runtime facts:** 79c3a316fdeba0e2a5966a14b3bd8b262de8099a119b3fcdb47de874db1aed3e

[Complete OpenAPI definition](https://aisa.one/docs/reference-contracts/api-sports.json)

Effective request and pricing declaration (including authentication and referenced schemas):

```json theme={null}
{
  "operationId": "api-sports.get-fixtures-statistics",
  "method": "POST",
  "path": "/apis/v1/api-sports/get-fixtures-statistics",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "requestBody": {
    "required": true,
    "content": {
      "application/json": {
        "schema": {
          "type": "object",
          "required": [
            "fixture"
          ],
          "properties": {
            "half": {
              "type": "boolean",
              "default": false,
              "examples": [
                true
              ],
              "description": "If true, includes halftime statistics in the response. Available for fixtures from the 2024 season onward."
            },
            "team": {
              "type": "integer",
              "examples": [
                567
              ],
              "description": "Optional team ID to filter statistics Must be obtained from upstream tools (e.g., GetTeams); never guess or fabricate."
            },
            "type": {
              "enum": [
                "Shots on Goal",
                "Shots off Goal",
                "Shots insidebox",
                "Shots outsidebox",
                "Total Shots",
                "Blocked Shots",
                "Fouls",
                "Corner Kicks",
                "Offsides",
                "Ball Possession",
                "Yellow Cards",
                "Red Cards",
                "Goalkeeper Saves",
                "Total passes",
                "Passes accurate",
                "Passes %"
              ],
              "type": "string",
              "description": "Statistic type to filter results (must match API's available types)"
            },
            "fixture": {
              "type": "integer",
              "examples": [
                12345
              ],
              "description": "ID of the fixture for which statistics are requested Must be obtained from upstream tools (e.g., GetFixtures); never guess or fabricate."
            }
          }
        }
      }
    }
  },
  "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


## OpenAPI

````yaml reference-contracts/api-sports.json POST /apis/v1/api-sports/get-fixtures-statistics
openapi: 3.1.0
info:
  description: ''
  title: API-Sports
  version: '1'
  x-aisa-capabilities:
    idempotency: Idempotency-Key
    max_price: X-AISA-Max-Price-USD
    quote:
      header: X-AISA-Cost-Mode
      value: quote
  x-aisa-configured-paths:
    - /apis/v1/api-sports/get-afl-games
    - /apis/v1/api-sports/get-afl-games-statistics-players
    - /apis/v1/api-sports/get-afl-seasons
    - /apis/v1/api-sports/get-afl-standings
    - /apis/v1/api-sports/get-baseball-games-h2h
    - /apis/v1/api-sports/get-basketball-bets
    - /apis/v1/api-sports/get-basketball-bookmakers
    - /apis/v1/api-sports/get-basketball-games
    - /apis/v1/api-sports/get-basketball-games-statistics-players
    - /apis/v1/api-sports/get-basketball-standings
    - /apis/v1/api-sports/get-basketball-statistics
    - /apis/v1/api-sports/get-coachs
    - /apis/v1/api-sports/get-countries
    - /apis/v1/api-sports/get-fighters-records
    - /apis/v1/api-sports/get-fixtures
    - /apis/v1/api-sports/get-fixtures-events
    - /apis/v1/api-sports/get-fixtures-headtohead
    - /apis/v1/api-sports/get-fixtures-lineups
    - /apis/v1/api-sports/get-fixtures-players
    - /apis/v1/api-sports/get-fixtures-rounds
    - /apis/v1/api-sports/get-fixtures-statistics
    - /apis/v1/api-sports/get-games-events
    - /apis/v1/api-sports/get-games-quarters
    - /apis/v1/api-sports/get-games-statistics-teams
    - /apis/v1/api-sports/get-injuries
    - /apis/v1/api-sports/get-leagues
    - /apis/v1/api-sports/get-leagues-seasons
    - /apis/v1/api-sports/get-mma-categories
    - /apis/v1/api-sports/get-mma-fighters
    - /apis/v1/api-sports/get-mma-fights
    - /apis/v1/api-sports/get-mma-fights-results
    - /apis/v1/api-sports/get-mma-fights-statistics-fighters
    - /apis/v1/api-sports/get-nba-games-statistics
    - /apis/v1/api-sports/get-nba-players-statistics
    - /apis/v1/api-sports/get-odds
    - /apis/v1/api-sports/get-odds-bets
    - /apis/v1/api-sports/get-odds-bookmakers
    - /apis/v1/api-sports/get-odds-live
    - /apis/v1/api-sports/get-odds-live-bets
    - /apis/v1/api-sports/get-odds-mapping
    - /apis/v1/api-sports/get-players
    - /apis/v1/api-sports/get-players-profiles
    - /apis/v1/api-sports/get-players-seasons
    - /apis/v1/api-sports/get-players-squads
    - /apis/v1/api-sports/get-players-statistics
    - /apis/v1/api-sports/get-players-teams
    - /apis/v1/api-sports/get-players-top-assists
    - /apis/v1/api-sports/get-players-top-red-cards
    - /apis/v1/api-sports/get-players-top-scorers
    - /apis/v1/api-sports/get-players-top-yellow-cards
    - /apis/v1/api-sports/get-predictions
    - /apis/v1/api-sports/get-sidelined
    - /apis/v1/api-sports/get-standings-stages
    - /apis/v1/api-sports/get-teams
    - /apis/v1/api-sports/get-teams-seasons
    - /apis/v1/api-sports/get-teams-statistics
    - /apis/v1/api-sports/get-timezone
    - /apis/v1/api-sports/get-transfers
    - /apis/v1/api-sports/get-trophies
    - /apis/v1/api-sports/get-venues
  x-aisa-document:
    facts_hash: 79c3a316fdeba0e2a5966a14b3bd8b262de8099a119b3fcdb47de874db1aed3e
    generator_version: '3'
    protocol_version: '1'
    schema_version: '1'
    composer_version: '28'
    response_pending: []
    document_hash: sha256:a4e4e82009d74c7c040fa84b8ce8bb4fc84da08a71d667c44c2f0988dc5f413c
  x-aisa-plans:
    builder: 1
    display_plan: payg
    payg: 1
    similarweb_payg: 1
    team: 1
    version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
  x-aisa-provider: api-sports
  x-aisa-catalogs:
    api-sports:
      title: API-Sports
      description: ''
      x-aisa-document:
        facts_hash: 79c3a316fdeba0e2a5966a14b3bd8b262de8099a119b3fcdb47de874db1aed3e
        generator_version: '3'
        protocol_version: '1'
        schema_version: '1'
      x-aisa-plans:
        builder: 1
        display_plan: payg
        payg: 1
        similarweb_payg: 1
        team: 1
        version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb
      x-aisa-capabilities:
        idempotency: Idempotency-Key
        max_price: X-AISA-Max-Price-USD
        quote:
          header: X-AISA-Cost-Mode
          value: quote
servers:
  - url: https://api.aisa.one
security:
  - bearerAuth: []
paths:
  /apis/v1/api-sports/get-fixtures-statistics:
    post:
      tags:
        - API-Sports
      summary: Get fixture statistics
      description: >-
        <!-- 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 -->
      operationId: api-sports.get-fixtures-statistics
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - fixture
              properties:
                half:
                  type: boolean
                  default: false
                  examples:
                    - true
                  description: >-
                    If true, includes halftime statistics in the response.
                    Available for fixtures from the 2024 season onward.
                team:
                  type: integer
                  examples:
                    - 567
                  description: >-
                    Optional team ID to filter statistics Must be obtained from
                    upstream tools (e.g., GetTeams); never guess or fabricate.
                type:
                  enum:
                    - Shots on Goal
                    - Shots off Goal
                    - Shots insidebox
                    - Shots outsidebox
                    - Total Shots
                    - Blocked Shots
                    - Fouls
                    - Corner Kicks
                    - Offsides
                    - Ball Possession
                    - Yellow Cards
                    - Red Cards
                    - Goalkeeper Saves
                    - Total passes
                    - Passes accurate
                    - Passes %
                  type: string
                  description: >-
                    Statistic type to filter results (must match API's available
                    types)
                fixture:
                  type: integer
                  examples:
                    - 12345
                  description: >-
                    ID of the fixture for which statistics are requested Must be
                    obtained from upstream tools (e.g., GetFixtures); never
                    guess or fabricate.
      responses:
        '200':
          description: Tool result data
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/Response576A0Ea506F3_connect_API_SPORTS_GET_FIXTURES_STATISTICS__output__public_data
        default:
          content:
            application/json:
              schema: {}
          description: >-
            Error response; upstream passthrough responses may use provider
            formats
      x-codeSamples:
        - lang: text
          label: Reference example
          source: >-
            # Fixed reference example. Playground inputs do not update this
            sample.

            curl --request POST \
              --url https://api.aisa.one/apis/v1/api-sports/get-fixtures-statistics \
              --header 'Authorization: Bearer <token>' \
              --header 'Content-Type: application/json' \
              --data '{
              "fixture": 12345
            }'
components:
  schemas:
    Response576A0Ea506F3_connect_API_SPORTS_GET_FIXTURES_STATISTICS__output__public_data:
      $ref: >-
        #/components/schemas/Response576A0Ea506F3_connect_API_SPORTS_GET_FIXTURES_STATISTICS__output__fcb309c21063ab20
    Response576A0Ea506F3_connect_API_SPORTS_GET_FIXTURES_STATISTICS__output__fcb309c21063ab20:
      type: object
      required:
        - get
        - parameters
        - errors
        - response
      properties:
        get:
          type: string
        errors:
          anyOf:
            - type: array
              items:
                type: string
            - type: object
              additionalProperties:
                type: string
        paging:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_API_SPORTS_GET_FIXTURES_STATISTICS__output__f284f27db6478322
        results:
          type: integer
        response:
          type: array
          items:
            $ref: >-
              #/components/schemas/Response576A0Ea506F3_connect_API_SPORTS_GET_FIXTURES_STATISTICS__output__b193fea0ee163f1b
        parameters:
          type: object
          additionalProperties:
            anyOf:
              - type: integer
              - type: boolean
              - type: string
    Response576A0Ea506F3_connect_API_SPORTS_GET_FIXTURES_STATISTICS__output__f284f27db6478322:
      type: object
      required:
        - current
        - total
      properties:
        total:
          type: integer
        current:
          type: integer
    Response576A0Ea506F3_connect_API_SPORTS_GET_FIXTURES_STATISTICS__output__b193fea0ee163f1b:
      type: object
      required:
        - team
        - statistics
      properties:
        team:
          $ref: >-
            #/components/schemas/Response576A0Ea506F3_connect_API_SPORTS_GET_FIXTURES_STATISTICS__output__5a5d75cf7df8e8e1
        statistics:
          type: array
          items:
            $ref: >-
              #/components/schemas/Response576A0Ea506F3_connect_API_SPORTS_GET_FIXTURES_STATISTICS__output__2707b9ff06d9d043
    Response576A0Ea506F3_connect_API_SPORTS_GET_FIXTURES_STATISTICS__output__5a5d75cf7df8e8e1:
      type: object
      required:
        - id
        - name
      properties:
        id:
          type: integer
        logo:
          type: string
        name:
          type: string
    Response576A0Ea506F3_connect_API_SPORTS_GET_FIXTURES_STATISTICS__output__2707b9ff06d9d043:
      type: object
      required:
        - type
      properties:
        type:
          type: string
        value:
          anyOf:
            - type: string
            - type: integer
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.