> ## 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 Settlements

> Returns the settlement record for up to 50 events: status, whether the result is final, and the final scores. Every id gets an answer, including cancelled and not yet resulted events. Paid plans only.



## OpenAPI

````yaml /api-reference/openapi.json get /settlements
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:
  /settlements:
    get:
      tags:
        - Settlement
      summary: Get Settlements
      description: >-
        Returns the settlement record for up to 50 events: status, whether the
        result is final, and the final scores. Every id gets an answer,
        including cancelled and not yet resulted events. Paid plans only.
      parameters:
        - description: API key for authentication
          name: apiKey
          in: query
          required: true
          schema:
            type: string
        - example: 74919888,73722728
          description: Comma-separated event ids (1 to 50)
          name: eventIds
          in: query
          required: true
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.SettlementsResponse'
        '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: Paid plans only
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '429':
          description: Too Many Requests
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
        '503':
          description: Storage unavailable
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/controllers.ErrorResponse'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    controllers.SettlementsResponse:
      type: object
      properties:
        settlements:
          type: array
          items:
            $ref: '#/components/schemas/controllers.SettlementResponse'
        notFound:
          type: array
          description: Event ids we have never seen.
          items:
            type: string
          example:
            - '999'
    controllers.ErrorResponse:
      type: object
      properties:
        error:
          type: string
          example: Error message
    controllers.SettlementResponse:
      type: object
      properties:
        eventId:
          type: integer
          example: 74919888
        sport:
          type: string
          example: Football
        status:
          type: string
          enum:
            - pending
            - live
            - awaiting_result
            - settled
            - cancelled
          example: settled
        final:
          type: boolean
          description: True when you can stop polling this event.
          example: true
        settledAt:
          type: string
          format: date-time
          description: When we recorded the final state. Omitted when unknown.
          example: '2026-10-04T19:02:11Z'
        scores:
          allOf:
            - $ref: '#/components/schemas/dto.Score'
          description: Present only for settled events with a usable score.
    dto.Score:
      type: object
      properties:
        away:
          type: integer
        home:
          type: integer
        periods:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/dto.PeriodScore'
    dto.PeriodScore:
      type: object
      properties:
        away:
          type: integer
        home:
          type: integer
        overs:
          $ref: '#/components/schemas/dto.SideFloats'
          description: Cricket only. Overs bowled by each side in this innings.
        wickets:
          $ref: '#/components/schemas/dto.SideInts'
          description: Cricket only. Wickets lost by each side in this innings.
    dto.SideFloats:
      type: object
      description: >-
        Home/away pair that can be fractional. Cricket overs use cricket
        notation: 19.3 means nineteen overs and three balls.
      properties:
        away:
          type: number
          example: 20
        home:
          type: number
          example: 20
    dto.SideInts:
      type: object
      description: Home/away pair of whole numbers (cricket wickets).
      properties:
        away:
          type: integer
          example: 9
        home:
          type: integer
          example: 6

````

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