API documentation

Get Lottery

Returns one lottery by game code with current metadata and latest result.

Section

20 / 27

OpenAPI JSON

Live API examples

Jump from the docs to real public pages that use the same read models.

Latest results browserSee the compact public result model with filters and draw dates.

Lottery catalogFind game names, states, ball counts, latest numbers, and API guides.

Maryland Pick 3 API guideOpen a concrete endpoint example using the same game shown in snippets.

Pricing and limitsCompare freshness targets, request limits, and integration features.

Customer integration centerSign in to check API keys, usage, webhook delivery, plan limits, and the next recommended action.

OpenAPI contractUse the machine-readable contract for code generation and integration tests.

Responsible data use

API examples and sample responses are integration references. Customers are responsible for local age, lottery, gambling, and disclosure rules in their own products.

Lottery Feed API is a data/API service, not a gambling operator. Public pages and customer integrations should show age/legal requirements where applicable and should not present historical statistics as a way to improve winning odds.

U.S. problem-gambling help resources are available from the National Council on Problem Gambling. Use jurisdiction-specific help links where local rules require them.

Request

Use stable game codes from the catalog. Add date=YYYY-MM-DD when a worker needs the same response to include schedule context for a selected draw date.

GET https://api.lotteryfeedapi.com/v1/lotteries/md-pick3-midday?date=2026-05-25

Response

The response includes compact schedule metadata, optional date_context, next_draw polling context, the selected canonical source, and confidence status. Timezone IDs are preserved when available so clients can handle daylight saving time correctly.

{
  "game_code": "md-pick3-midday",
  "name": "Maryland Pick 3 Midday",
  "links": {
    "canonical": "/lotteries/md-pick3-midday",
    "latest_result": "/lotteries/md-pick3-midday",
    "api": "/v1/lotteries/md-pick3-midday",
    "api_docs": "/api-docs/lotteries",
    "api_integration": "/lotteries/md-pick3-midday/api-integration",
    "schedule_api": "/v1/schedules?game_code=md-pick3-midday"
  },
  "draw_schedule": {
    "local_time": "12:27 PM ET",
    "utc_time": "16:27 UTC",
    "days": "Every day",
    "description": "Every day.",
    "timezone": "America/New_York",
    "next_draw": {
      "date": "2026-05-25",
      "local_time": "12:27 PM EDT",
      "utc_time": "16:27 UTC",
      "local_datetime": "2026-05-25T12:27:00",
      "utc_datetime": "2026-05-25T16:27:00Z",
      "timezone": "America/New_York",
      "days_until": 0,
      "polling_window": {
        "first_check_after_utc": "2026-05-25T16:37:00Z",
        "retry_until_utc": "2026-05-25T18:27:00Z",
        "first_check_delay_minutes": 10,
        "retry_window_minutes": 120,
        "label": "Start result checks at 2026-05-25T16:37:00Z; keep retries bounded until 2026-05-25T18:27:00Z unless your plan or source policy says otherwise."
      },
      "label": "Next scheduled draw on Monday, May 25, 2026 at 12:27 PM EDT (16:27 UTC)."
    },
    "source": {
      "label": "Maryland Lottery rules",
      "url": "https://www.mdlottery.com/"
    }
  },
  "date_context": {
    "date": "2026-05-25",
    "status": "scheduled",
    "label": "Scheduled on Monday. Every day."
  },
  "latest_draw": {
    "draw_date": "2026-05-25",
    "numbers": ["2", "3", "6"],
    "numbers_formatted": "2-3-6",
    "source": "mdlottery.com",
    "status": "official",
    "source_confidence": {
      "level": "official",
      "label": "Official source",
      "policy": "Numbers were published from the official or canonical lottery source path."
    }
  }
}

Compact prize review coverage

Use include=prize_structure_coverage on catalog calls to inspect publication readiness without returning payout rows. Prize data remains unavailable until amount currency, scale, source evidence, and publication approval are explicit.

GET https://api.lotteryfeedapi.com/v1/lotteries?state=TN&include=prize_structure_coverage

{
  "data": [
    {
      "game_code": "tn-pick3-morning",
      "name": "Tennessee Cash 3 Morning",
      "prize_structure_coverage": {
        "status": "not_source_reviewed",
        "label": "Prize structure publication pending",
        "summary": "Prize rows remain hidden until amounts use an explicit currency and scale and the source evidence is approved for public publication.",
        "include": "prize_structure_coverage",
        "prize_table_include": "prize_structure"
      }
    }
  ]
}

Optional prize structure projection

Use include=prize_structure on a single-lottery lookup to request publication status. Until typed currency, scale, source evidence, and publication approval are available, the API returns a compact notice instead of payout rows.

GET https://api.lotteryfeedapi.com/v1/lotteries/tn-pick3-morning?include=prize_structure

{
  "game_code": "tn-pick3-morning",
  "name": "Tennessee Cash 3 Morning",
  "prize_structure_notice": {
    "status": "not_source_reviewed",
    "label": "Prize structure publication pending",
    "summary": "Prize rows remain hidden until amounts use an explicit currency and scale and the source evidence is approved for public publication.",
    "guidance": [
      "Use published results, history, schedules, and source-confidence metadata while prize publication is pending.",
      "Do not infer prizes or ticket costs from another game, draw, jurisdiction, or untyped display string."
    ],
    "include": "prize_structure"
  }
}

Missing prize review response

When the prize table is not reviewed, keep your UI on official rules or hide prize claims. The API returns a notice rather than inferring another game or state.

GET https://api.lotteryfeedapi.com/v1/lotteries/md-pick3-midday?include=prize_structure

{
  "game_code": "md-pick3-midday",
  "name": "Maryland Pick 3 Midday",
  "prize_structure_notice": {
    "status": "not_source_reviewed",
    "label": "Prize structure not source-reviewed yet",
    "summary": "Lottery Feed API hides prize tables until the official rules are checked, dated, and reviewed for payout-safe customer display.",
    "guidance": [
      "Do not infer prizes from another state, another draw game, or a third-party summary.",
      "Use the official lottery rules for payout, eligibility, play-type availability, and local disclosures."
    ],
    "include": "prize_structure"
  }
}

Compact jackpot review coverage

Use include=jackpot_status on catalog calls when your backend only needs to know whether a lottery has reviewed jackpot tracking. The response never includes jackpot amount, currency, rollover, or source timestamp values until an official/canonical jackpot source is reviewed.

GET https://api.lotteryfeedapi.com/v1/lotteries?state=NY&include=jackpot_status

{
  "data": [
    {
      "game_code": "ny-lotto",
      "name": "New York Lotto",
      "jackpot_coverage": {
        "status": "not_source_reviewed",
        "label": "Jackpot tracking not source-reviewed yet",
        "summary": "New York Lotto jackpot values are hidden until an official jackpot source, source timestamp, amount, currency, and rollover semantics are reviewed.",
        "include": "jackpot_status",
        "jackpot_include": "jackpot"
      }
    }
  ]
}

Missing jackpot review response

Use include=jackpot on a single-lottery lookup when a customer UI needs to know whether reviewed jackpot data is available. Until that review is complete, the API returns a compact notice without amount, currency, rollover, cash-value, or annuity fields.

GET https://api.lotteryfeedapi.com/v1/lotteries/ny-lotto?include=jackpot

{
  "game_code": "ny-lotto",
  "name": "New York Lotto",
  "jackpot_notice": {
    "status": "not_source_reviewed",
    "label": "Jackpot not source-reviewed yet",
    "summary": "New York Lotto jackpot tracking is not enabled until official jackpot evidence is reviewed and dated.",
    "guidance": [
      "No jackpot amount, currency, rollover, cash-value, or annuity fields are available for this game.",
      "Use published result, schedule, history, and source-confidence fields until reviewed jackpot data is available."
    ],
    "include": "jackpot"
  }
}

Next: Get schedules

{ "game_code": "md-pick3-midday", "name": "Maryland Pick 3 Midday", "links": { "canonical": "/lotteries/md-pick3-midday", "latest_result": "/lotteries/md-pick3-midday", "api": "/v1/lotteries/md-pick3-midday", "api_docs": "/api-docs/lotteries", "api_integration": "/lotteries/md-pick3-midday/api-integration", "schedule_api": "/v1/schedules?game_code=md-pick3-midday" }, "draw_schedule": { "local_time": "12:27 PM ET", "utc_time": "16:27 UTC", "days": "Every day", "description": "Every day.", "timezone": "America/New_York", "next_draw": { "date": "2026-05-25", "local_time": "12:27 PM EDT", "utc_time": "16:27 UTC", "local_datetime": "2026-05-25T12:27:00", "utc_datetime": "2026-05-25T16:27:00Z", "timezone": "America/New_York", "days_until": 0, "polling_window": { "first_check_after_utc": "2026-05-25T16:37:00Z", "retry_until_utc": "2026-05-25T18:27:00Z", "first_check_delay_minutes": 10, "retry_window_minutes": 120, "label": "Start result checks at 2026-05-25T16:37:00Z; keep retries bounded until 2026-05-25T18:27:00Z unless your plan or source policy says otherwise." }, "label": "Next scheduled draw on Monday, May 25, 2026 at 12:27 PM EDT (16:27 UTC)." }, "source": { "label": "Maryland Lottery rules", "url": "https://www.mdlottery.com/" } }, "date_context": { "date": "2026-05-25", "status": "scheduled", "label": "Scheduled on Monday. Every day." }, "latest_draw": { "draw_date": "2026-05-25", "numbers": ["2", "3", "6"], "numbers_formatted": "2-3-6", "source": "mdlottery.com", "status": "official", "source_confidence": { "level": "official", "label": "Official source", "policy": "Numbers were published from the official or canonical lottery source path." } } }

{ "data": [ { "game_code": "tn-pick3-morning", "name": "Tennessee Cash 3 Morning", "prize_structure_coverage": { "status": "not_source_reviewed", "label": "Prize structure publication pending", "summary": "Prize rows remain hidden until amounts use an explicit currency and scale and the source evidence is approved for public publication.", "include": "prize_structure_coverage", "prize_table_include": "prize_structure" } } ] }

{ "game_code": "tn-pick3-morning", "name": "Tennessee Cash 3 Morning", "prize_structure_notice": { "status": "not_source_reviewed", "label": "Prize structure publication pending", "summary": "Prize rows remain hidden until amounts use an explicit currency and scale and the source evidence is approved for public publication.", "guidance": [ "Use published results, history, schedules, and source-confidence metadata while prize publication is pending.", "Do not infer prizes or ticket costs from another game, draw, jurisdiction, or untyped display string." ], "include": "prize_structure" } }

{ "game_code": "md-pick3-midday", "name": "Maryland Pick 3 Midday", "prize_structure_notice": { "status": "not_source_reviewed", "label": "Prize structure not source-reviewed yet", "summary": "Lottery Feed API hides prize tables until the official rules are checked, dated, and reviewed for payout-safe customer display.", "guidance": [ "Do not infer prizes from another state, another draw game, or a third-party summary.", "Use the official lottery rules for payout, eligibility, play-type availability, and local disclosures." ], "include": "prize_structure" } }

{ "data": [ { "game_code": "ny-lotto", "name": "New York Lotto", "jackpot_coverage": { "status": "not_source_reviewed", "label": "Jackpot tracking not source-reviewed yet", "summary": "New York Lotto jackpot values are hidden until an official jackpot source, source timestamp, amount, currency, and rollover semantics are reviewed.", "include": "jackpot_status", "jackpot_include": "jackpot" } } ] }

{ "game_code": "ny-lotto", "name": "New York Lotto", "jackpot_notice": { "status": "not_source_reviewed", "label": "Jackpot not source-reviewed yet", "summary": "New York Lotto jackpot tracking is not enabled until official jackpot evidence is reviewed and dated.", "guidance": [ "No jackpot amount, currency, rollover, cash-value, or annuity fields are available for this game.", "Use published result, schedule, history, and source-confidence fields until reviewed jackpot data is available." ], "include": "jackpot" } }