Retrieve Live Draw Information via API

Updated 07 July 2025 02:15

To gather live draw information for marketing emails, you can use relevant API endpoints on the Jumbo Lottery Platform. This lets you build engaging, up-to-date email content that showcases your draws with all the visuals and information needed to attract players without having to manually update your email templates.

Endpoint 1:

https://api.charitylotteries.com.au/api/v2/pricing/australia_qld/product_offers/lottery_product

This endpoint is used to retrieve a list of currently available product offers (active or upcoming draws) for a specified lottery product.

Purpose

To fetch live or upcoming draws with core details like ticket pricing, draw dates, and hero image assets.

Request

Method: GET
Auth: Public (no authentication required)
No body or query parameters

Response Example (abbreviated)

{
  "product_offers": [
    {
      "draw_id": 123,
      "offer_title": "Lottery Draw 123",
      "offer_description": "Win a luxury home in the hinterland...",
      "start_date": "2025-05-01T00:00:00Z",
      "end_date": "2025-07-03T23:59:59Z",
      "draw_date": "2025-07-05T10:00:00Z",
      "ticket_price": 5.0,
      "image_urls": {
        "main": "<https://cdn.charitylotteries.com.au/images/draw123/main.jpg>",
        "thumbnail": "<https://cdn.charitylotteries.com.au/images/draw123/thumb.jpg>"
      }
    }
  ]
}

Key Fields to Extract

Field	Description
`draw_id`	ID used to query detailed draw info
`offer_title`	Name of the draw (e.g. “Draw 123”)
`offer_description`	Short blurb or marketing hook
`start_date`	When ticket sales begin
`end_date`	When ticket sales close
`draw_date`	Scheduled draw date
`ticket_price`	Cost per ticket
`image_urls`	URLs to main and thumbnail marketing images

Endpoint 2:

https://api.charitylotteries.com.au/api/v2/draw/details/lottery_product/123

This endpoint returns detailed marketing and prize information for a specific draw using the draw_id.

Purpose

To get full details about the prize, gallery images, features, location, and supporting media for a single draw.

Request

Method: GET
Auth: Public
URL Parameter: Replace 123 with any valid draw_id

Response Example (abbreviated)

{
  "draw": {
    "id": 123,
    "title": "Lottery Draw 123",
    "prize_description": "A modern 4-bedroom home with a pool and Tesla...",
    "location": "Gold Coast, QLD",
    "video_url": "<https://cdn.charitylotteries.com.au/videos/draw123.mp4>",
    "images": [
      "<https://cdn.charitylotteries.com.au/images/draw123/gallery1.jpg>",
      "<https://cdn.charitylotteries.com.au/images/draw123/gallery2.jpg>"
    ],
    "key_features": [
      "4 bedrooms",
      "Infinity pool",
      "Electric vehicle included"
    ],
    "terms_url": "<https://www.charitylotteries.com.au/terms/draw123>"
  }
}

Key Fields to Extract

Field	Description
`title`	Official draw name
`prize_description`	Detailed prize narrative for promotional use
`location`	Prize location or setting
`video_url`	Link to promotional video
`images[]`	Full gallery image URLs
`key_features[]`	Feature bullets (e.g. rooms, extras)
`terms_url`	Link to the draw's terms and conditions

Usage Flow Summary

Get active draws:
- Call endpoint 1: /product_offers/lottery_product
- Extract high-level draw info and associated draw_id
Get detailed draw info:
- For each draw_id, call endpoint 2: /draw/details/lottery_product/{draw_id}
- Use data for full marketing content, features, and legal links

Practical Applications

Display active draws in a frontend interface with title, date, and images
Create email and push campaigns using description, gallery, and features
Generate promotional content using prize narratives and media assets
Link to draw-specific T&Cs for compliance and customer transparency