API Documentation

Complete guide to integrate IPL Cricket data into your application

Getting Started

Authentication

All API requests require an API key. Include your key in the request header:

X-API-Key: your_api_key_here

Base URL

https://api.iplapi.online

API Endpoints

GET/matches/live

Get all live IPL matches

Example Request

curl -X GET 'https://api.iplapi.online/matches/live' \
  -H 'X-API-Key: your_api_key'

Example Response

{
  "match_id": "ipl_2024_m45",
  "status": "live",
  "teams": {
    "team1": {
      "name": "Mumbai Indians",
      "short_name": "MI",
      "score": "178/5",
      "overs": "18.4"
    },
    "team2": {
      "name": "Chennai Super Kings",
      "short_name": "CSK",
      "score": "165/8",
      "overs": "20.0"
    }
  },
  "current_status": "MI need 13 runs in 8 balls",
  "venue": "Wankhede Stadium, Mumbai",
  "toss": "CSK won the toss and elected to bat"
}

GET/scorecard/:match_id

Get detailed scorecard for a specific match

Example Request

curl -X GET 'https://api.iplapi.online/scorecard/:match_id' \
  -H 'X-API-Key: your_api_key'

Example Response

{
  "match_id": "ipl_2024_m45",
  "team": "Chennai Super Kings",
  "innings": 1,
  "total": "165/8",
  "overs": "20.0",
  "batsmen": [
    {
      "name": "Ruturaj Gaikwad",
      "runs": 45,
      "balls": 32,
      "fours": 5,
      "sixes": 2,
      "strike_rate": 140.62,
      "status": "c Rohit b Bumrah"
    },
    {
      "name": "Devon Conway",
      "runs": 28,
      "balls": 24,
      "fours": 3,
      "sixes": 1,
      "strike_rate": 116.67,
      "status": "lbw b Patel"
    },
    {
      "name": "Ajinkya Rahane",
      "runs": 35,
      "balls": 28,
      "fours": 4,
      "sixes": 1,
      "strike_rate": 125,
      "status": "not out"
    },
    {
      "name": "Shivam Dube",
      "runs": 22,
      "balls": 15,
      "fours": 2,
      "sixes": 1,
      "strike_rate": 146.67,
      "status": "c Kishan b Bumrah"
    }
  ],
  "bowlers": [
    {
      "name": "Jasprit Bumrah",
      "overs": 4,
      "maidens": 0,
      "runs": 28,
      "wickets": 3,
      "economy": 7
    },
    {
      "name": "Piyush Chawla",
      "overs": 4,
      "maidens": 0,
      "runs": 32,
      "wickets": 2,
      "economy": 8
    }
  ]
}

GET/players

Get list of all IPL players with stats

Example Request

curl -X GET 'https://api.iplapi.online/players' \
  -H 'X-API-Key: your_api_key'

Example Response

{
  "players": [
    {
      "player_id": "p_001",
      "name": "Virat Kohli",
      "team": "Royal Challengers Bangalore",
      "role": "Batsman",
      "batting_style": "Right-hand bat",
      "bowling_style": "Right-arm medium",
      "stats": {
        "matches": 237,
        "runs": 7263,
        "average": 37.25,
        "strike_rate": 130.02,
        "fifties": 50,
        "hundreds": 7
      }
    },
    {
      "player_id": "p_002",
      "name": "Jasprit Bumrah",
      "team": "Mumbai Indians",
      "role": "Bowler",
      "batting_style": "Right-hand bat",
      "bowling_style": "Right-arm fast",
      "stats": {
        "matches": 133,
        "wickets": 165,
        "average": 23.55,
        "economy": 7.18,
        "best_bowling": "5/10"
      }
    }
  ],
  "total": 500
}

GET/players/:player_id

Get detailed information about a specific player

Example Request

curl -X GET 'https://api.iplapi.online/players/:player_id' \
  -H 'X-API-Key: your_api_key'

Example Response

{
  "player_id": "p_001",
  "name": "Virat Kohli",
  "team": "Royal Challengers Bangalore",
  "role": "Batsman",
  "batting_style": "Right-hand bat",
  "bowling_style": "Right-arm medium",
  "stats": {
    "matches": 237,
    "runs": 7263,
    "average": 37.25,
    "strike_rate": 130.02,
    "fifties": 50,
    "hundreds": 7
  }
}

GET/teams

Get list of all IPL teams

Example Request

curl -X GET 'https://api.iplapi.online/teams' \
  -H 'X-API-Key: your_api_key'

Example Response

{
  "teams": [
    {
      "team_id": "t_001",
      "name": "Mumbai Indians",
      "short_name": "MI",
      "home_ground": "Wankhede Stadium"
    },
    {
      "team_id": "t_002",
      "name": "Chennai Super Kings",
      "short_name": "CSK",
      "home_ground": "M. A. Chidambaram Stadium"
    }
  ]
}

GET/standings

Get current IPL points table

Example Request

curl -X GET 'https://api.iplapi.online/standings' \
  -H 'X-API-Key: your_api_key'

Example Response

{
  "standings": [
    {
      "position": 1,
      "team": "Gujarat Titans",
      "matches": 14,
      "won": 10,
      "lost": 4,
      "points": 20,
      "nrr": "+0.809"
    },
    {
      "position": 2,
      "team": "Rajasthan Royals",
      "matches": 14,
      "won": 9,
      "lost": 5,
      "points": 18,
      "nrr": "+0.448"
    }
  ]
}

Rate Limits

Free Tier

100

requests per day

Pro Tier

10,000

requests per day

Enterprise

Unlimited

custom limits

Error Codes

Code	Description
200	Success - Request completed successfully
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid or missing API key
429	Too Many Requests - Rate limit exceeded
500	Server Error - Something went wrong on our end