API Documentation

Welcome to the Kind Interactive Lottery Data API. Our REST-based API provides comprehensive access to real-time and historical lottery results from over 500 lotteries worldwide.

Base URL

Get Base URL from your account manager.

Authentication

Access to the API requires an API Key. Depending on your assigned domain (BASE_URL), include your key in the query parameters or request headers.

GET /Api/list?token=YOUR_API_KEY

GET

All Lotteries List

Retrieve a comprehensive list of all supported lotteries including their latest draw summary, upcoming jackpots, and next draw times.

                    /Api/list
                

Request Example

curl -X GET "https://BASE_URL/Api/list"

Response Example

{
  "status": 200,
  "code": 0,
  "message": "",
  "data": [
    {
      "id": "4082521",
      "lotteryid": "1",
      "lotteryname": "Powerball",
      "slug": "usa-powerball",
      "drawdate": "06 Jan, 2026",
      "jackpot": "$86,000,000",
      "currency": "USD",
      "regularnumbers": ["4", "18", "24", "51", "56"],
      "extranumbers": ["14"],
      "nextjackpot": "$105,000,000",
      "nextDrawDateTime": "08 Jan, 2026",
      "color": "#da3c37"
    },
    ...
  ]
}

GET

History Results

Retrieve historical draw results for a specific lottery. Includes payout tables and probability data.

                    /Api/pureHistoryResults?lotto={slug}&pagesize={n}
                

Query Parameters

Parameter	Type	Required	Description
lotto	String	Yes	The slug of the lottery (e.g., `usa-powerball`)
pagesize	Int	No	Number of results to return (default: 10)

Request Example

curl -X GET "https://BASE_URL/Api/pureHistoryResults?lotto=usa-powerball&pagesize=30"

Response Example

{
  "status": 200,
  "data": {
    "lottoInfo": {
      "lotteryname": "Powerball",
      "nextjackpot": "$105,000,000",
      "nextDrawDateTime": "08 Jan, 2026"
    },
    "lottoResults": [
      {
        "drawtime": "2026-01-06",
        "jackpot": "$86,000,000",
        "regularnumbers": ["4","18","24","51","56"],
        "extranumbers": ["14"],
        "payouttable": [
          {"matched": "5 + 1", "payout": "$0", "probability": "1/292,201,338"},
          {"matched": "5", "payout": "$0", "probability": "1/11,688,053"}
        ]
      }
    ]
  }
}

GET

Draw Detail

Get deep information about a specific draw, including extended meta data, how-to-play instructions, and full prize breakdowns.

                    /Api/detail?lotto={slug}&drawdate={YYYY-MM-DD}
                

Query Parameters

Parameter	Type	Required	Description
lotto	String	Yes	The slug of the lottery
drawdate	String	Yes	The date of the draw in YYYY-MM-DD format

Response Example

{
  "status": 200,
  "data": {
    "lottoInfo": {
      "lotteryname": "Powerball",
      "introduction": "... (HTML content)",
      "howtoplay": "... (HTML content)",
      "nextjackpot": "$105,000,000"
    }
  }
}

Indian Lotteries

Raffle-style Guide

Unlike standard "Lotto" games (where users pick numbers from a pool), Indian lotteries like Kerala and Dear Lottery are Raffle-style paper lotteries.

Pre-printed Tickets: Each ticket has a unique serial number (e.g., SS-501, 86A76183).
Fixed Prizes: Results are published as winning serial numbers across different prize ranks (1st prize, 2nd prize, etc.).
Multiple Draws: Some providers (like Dear Lottery) host multiple draws per day (1PM, 6PM, 8PM).

Kerala Lottery API

Specialized endpoints for Kerala State Government Raffle Lotteries (Win-Win, Sthree Sakthi, Akshaya, etc.).

GET

Past 100 Raw Data

Retrieve the complete raw dataset for the last 100 draws.

                            /Api/keralaLotteryRawData
                        

Request Example

curl -X GET "https://BASE_URL/Api/keralaLotteryRawData"

GET

History Draw List

Paginated list of historical draws.

                            /Api/keralaLotteryHistoryDrawList?page={n}&pagesize={n}
                        

Request Example

curl -X GET "https://BASE_URL/Api/keralaLotteryHistoryDrawList?page=1&pagesize=10"

GET

Next Draw Info

Get information about the upcoming Kerala lottery draw.

                            /Api/keralaLotteryNextDraw
                        

Response Example

{
  "status": 200,
  "data": {
    "game_name": "DHANALEKSHMI",
    "draw_code": "DL-34",
    "draw_datetime": "2026-01-07 20:30:00",
    "playable": true,
    "link": "..."
  }
}

GET

Draw Details

Get full prize breakdown and winning ticket numbers for a specific draw code.

                            /Api/keralaLotteryDrawDetails?drawcode={code}
                        

Request Example

curl -X GET "https://BASE_URL/Api/keralaLotteryDrawDetails?drawcode=KR-683"

Dear Lottery API

Endpoints for Dear Lottery (Nagaland State), covering 1PM, 6PM, and 8PM daily draws.

GET

History by Type

Retrieve results for a specific draw time (e.g., 1PM, 6PM, 8PM).

                            /Api/dearLotteryHistoryDrawList?type={type}&page={n}&pagesize={n}
                        

Request Example

curl -X GET "https://BASE_URL/Api/dearLotteryHistoryDrawList?type=1PM&page=1&pagesize=2"

GET

All Types Raw Data

Get a combined feed of all Dear Lottery draw types.

                            /Api/dearLotteryRawData?page={n}&pagesize={n}
                        

GET

Today's Results

Retrieve all draws scheduled for today.

                            /Api/dearLotteryToday
                        

GET

Results by Date

Filter draws by a specific date.

                            /Api/dearLotteryByDate?date={YYYY-MM-DD}
                        

Request Example

curl -X GET "https://BASE_URL/Api/dearLotteryByDate?date=2024-12-18"

GET

Next Draw Info

Countdown and metadata for the next scheduled draw.

                            /Api/dearLotteryNextDraw
                        

Response Example

{
  "status": 200,
  "data": {
    "lottery_name": "Indus Wednesday",
    "istTimeString": "1PM, Wed, Jan 07, 2026",
    "lottery_type": "1PM",
    "seconds_until_draw": 49576
  }
}

Error Codes

The API uses standard HTTP response codes and a custom status field within the JSON response body.

Response Structure

{
  "status": 200,      // HTTP Status Code
  "code": 0,          // Business Status Code (0 = Success)
  "message": "",      // Status or Error Message
  "data": { ... }     // Response Payload
}

Code	Description
0	Success - Operation completed successfully.
1	Parameter Error - Missing or invalid request parameters.
-1	Unknown Error - Internal server or processing error.
403	Forbidden - Invalid API Key or insufficient permissions.

Rate Limits

To ensure platform stability and fair usage, the following rate limits apply based on your subscription tier.

Plan	Requests / Minute	Monthly Quota
Starter	5 req/min	1,000 requests
Professional	100 req/min	Unlimited (Pay-as-you-go)
Enterprise	Unlimited*	Custom

Security & Stability Rules

IP-based Burst Protection: Sudden spikes of more than 20 requests per second from a single IP may trigger a temporary cooldown (30 seconds).
Concurrent Requests: A maximum of 5 simultaneous connections are allowed per API key to prevent session locking.
Global SLA: Enterprise tier accounts are guaranteed 99.99% availability and bypass shared rate limit pools.