Get all supported leagues

GET https://api.public.equls.com/v1/leagues

Returns a list of all valid leagues supported by the API, optionally filtered by sport

EQULS API - Get Leagues Endpoint

Overview

This endpoint retrieves a list of all valid leagues supported by the EQULS API.

Details

• URL: /v1/getLeagues
• Method: GET
• Authentication: Required (API Key)

Request Parameters

• apiKey: A required query parameter. It must be a valid 24-character hexadecimal API key for authentication.

Response

• Success (200 OK):

  • Returns a JSON object containing an array of supported leagues.
  • Example:
    JSON

    {
      "leagues": ["NFL", "NBA", "MLB", ...]
    }

• Error (401 Unauthorized):

  • Returned when the API key is missing or invalid.
  • Example:
    JSON

    {
      "error": "Invalid API key",
      "details": [
        {
          "code": "invalid_string",
          "message": "Must be a valid ObjectID string",
          "path": ["apiKey"]
        }
      ]
    }

Notes

• The API key must be a valid 24-character hexadecimal string in the MongoDB ObjectID format.
• The leagues list is maintained in the configuration and may be updated as new leagues are added to the platform.