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

# Get Odds Summary for Multiple Events

> The odds summary for up to 10 events in one request, counted as one request. Events that are not found are left out. Available on Growth plans and above. Free, Solo and Starter plans receive sample responses with demo set to true and an X-OddsAPI-Demo: true header.



## OpenAPI

````yaml /api-reference/openapi.json get /odds/summary/multi
openapi: 3.0.0
info:
  description: >-
    Odds-API.io is a powerful sports betting odds comparison API, providing
    real-time data from 365+ bookmakers across 34 sports with near zero latency.


    - 365+ bookmakers supported

    - 34 sports including Football, Basketball, Tennis, Esports and more

    - Real-time odds with close to zero latency

    - Pre-match & In-play odds coverage

    - 99.9% uptime for reliability
  title: Odds-API.io - Real-Time Sports Betting Odds API (v3)
  contact: {}
  version: 3.0.0
servers:
  - url: https://api.odds-api.io/v3
security: []
paths:
  /odds/summary/multi:
    get:
      tags:
        - Odds
      summary: Get Odds Summary for Multiple Events
      description: >-
        The odds summary for up to 10 events in one request, counted as one
        request. Events that are not found are left out. Available on Growth
        plans and above. Free, Solo and Starter plans receive sample responses
        with demo set to true and an X-OddsAPI-Demo: true header.
      parameters:
        - description: API key for authentication
          name: apiKey
          in: query
          required: true
          schema:
            type: string
        - description: Comma-separated event IDs, up to 10
          name: eventIds
          in: query
          required: true
          schema:
            type: string
        - description: >-
            Comma-separated market names, case-insensitive (default
            ML,Spread,Totals, max 20)
          name: markets
          in: query
          schema:
            type: string
        - description: main (default) or all
          name: lines
          in: query
          schema:
            type: string
        - description: >-
            Restrict the summary to these bookmakers. Each must be in your
            selected bookmakers
          name: bookmakers
          in: query
          schema:
            type: string
        - description: >-
            Add the best exchange back price per outcome in a separate exchanges
            block
          name: includeExchanges
          in: query
          schema:
            type: boolean
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/controllers.EventSummary'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '503':
          description: Service Unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    controllers.EventSummary:
      type: object
      properties:
        away:
          type: string
        computedAt:
          type: string
        date:
          type: string
        demo:
          type: boolean
        eventId:
          type: string
        home:
          type: string
        markets:
          type: array
          items:
            $ref: '#/components/schemas/controllers.SummaryMarket'
        message:
          type: string
        status:
          type: string
    controllers.ErrorResponse:
      type: object
      properties:
        error:
          type: string
          example: Error message
    controllers.SummaryMarket:
      type: object
      properties:
        lines:
          type: array
          items:
            $ref: '#/components/schemas/controllers.SummaryLine'
        name:
          type: string
    controllers.SummaryLine:
      type: object
      properties:
        books:
          type: integer
        exchanges:
          $ref: '#/components/schemas/controllers.SummaryExchanges'
        fairBooks:
          type: integer
        hdp:
          type: number
          nullable: true
        main:
          type: boolean
        outcomes:
          $ref: '#/components/schemas/controllers.SummaryOutcomes'
        payout:
          $ref: '#/components/schemas/controllers.SummaryPayout'
    controllers.SummaryExchanges:
      type: object
      additionalProperties:
        $ref: '#/components/schemas/controllers.SummaryExchangeQuote'
    controllers.SummaryOutcomes:
      type: object
      additionalProperties:
        $ref: '#/components/schemas/controllers.SummaryOutcome'
    controllers.SummaryPayout:
      type: object
      properties:
        average:
          type: number
        best:
          type: number
    controllers.SummaryExchangeQuote:
      type: object
      properties:
        best:
          type: number
        currency:
          type: string
        liquidity:
          type: number
        venue:
          type: string
    controllers.SummaryOutcome:
      type: object
      properties:
        average:
          type: number
        best:
          type: number
        bestBookmakers:
          type: array
          items:
            type: string
        excluded:
          type: integer
        fair:
          type: number
        median:
          type: number
        sharpFair:
          type: number
        worst:
          type: number

````

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