Open data

Sweepstakes Casino Open Data

Name: SweepState Sweepstakes Casino Index API
Creator: SweepState
License: https://creativecommons.org/licenses/by/4.0/

SweepState publishes its sweepstakes-casino index and US state-legality research as read-only data. This page documents each public surface, its fields, and how to cite it. No key is required.

How to read these examples

Every shape below is built from live data. Dates shown are real data events, never the day the page was rendered. The legality export carries a generatedAt build timestamp and per-row lastVerified dates. The ban timeline reports its data as of July 8, 2026.

Legal-map embed and exports

Use the map or download the state data

The iframe renders the same state-legality collection documented below. Keep the attribution line visible, replace your-domain with your hostname, and cite the dated export when using the data in an article or analysis.

JSON export/legal-map/data.json CSV export/legal-map/data.csv

Usage note: state legality can change. Do not treat availability as legal advice, and do not remove per-state source or last-verified context when republishing the export.

Copy-paste legal-map embed

The widget reads /embed/legal-map and keeps the data current without re-copying.

<!-- SweepState: US sweepstakes casino legality map -->
<iframe
  src="https://sweepstate.com/embed/legal-map?ref=data&src=your-domain"
  title="US Sweepstakes Casino Legality Map by SweepState"
  width="100%"
  height="620"
  style="border:0;max-width:900px;"
  loading="lazy"
  referrerpolicy="no-referrer-when-downgrade"
></iframe>
<p style="margin-top:8px;font-size:12px;color:#475569;text-align:center;">Map data by <a href="https://sweepstate.com/legal-map?ref=data-attribution&src=your-domain" target="_blank" rel="noopener noreferrer">SweepState</a>. US sweepstakes casino legality tracker.</p>

GET/api/casinos

Sweepstakes casino index (list)

Returns the scored index of tracked sweepstakes operators as JSON. Every record is the same merged operator object the review pages render, so the public score and facts match the site.

Open endpoint

Parameters

limit Maximum operators to return. Defaults to 10 when omitted.
state Two-letter state code to scope the list to operators available in that state.
featured Set to return only the featured shortlist.
search Free-text query (two or more characters) that switches the response to ranked search results.

Response fields

casinos Array of operator records (the merged factual plus editorial object).
total Count of operators in the casinos array.
query Echo of the search term. Present only on the search response.
results Ranked match metadata (id, name, score, matchedField). Present only on the search response.

Record fields

id Operator primary key, which is also the public slug.
name Operator display name.
slug URL slug, equal to id.
indexScore Canonical 0 to 10 Index score under the published methodology.
operator Parent operator or licensee, when held.
yearEstablished Launch year, when held.
... Additional public operator facts (currencies, game types, availability) as rendered on the review page.

Example

{
  "casinos": [
    {
      "id": "stake-us",
      "name": "Stake US",
      "slug": "stake-us",
      "indexScore": 9.1,
      "…": "additional public operator fields"
    }
  ],
  "total": 1
}

Version field: This list response has no envelope timestamp. Each operator record carries its own substantive editorial dates (fact-check and last-updated) sourced from the database.

Citation: Attribute to "SweepState" and link the specific review page. Index scores are editorial research estimates under the published methodology.

GET/api/casinos/{slug}

Sweepstakes casino (single record)

Returns one operator record by slug. The slug is the same value used in the review URL at /sweepstakes-casinos/{slug}. Unknown slugs return 404 and malformed slugs return 400.

Parameters

slug Operator slug, lower-case alphanumeric with hyphens (path segment).

Response fields

casino The merged operator object, identical in shape to one element of the list response casinos array.

Record fields

id Operator primary key, which is also the public slug.
name Operator display name.
indexScore Canonical 0 to 10 Index score.
... Same public operator facts as the list response record.

Example

{
  "casino": {
    "id": "stake-us",
    "name": "Stake US",
    "slug": "stake-us",
    "indexScore": 9.1,
    "…": "additional public operator fields"
  }
}

Version field: No envelope timestamp. The record carries its own fact-check and last-updated dates.

Citation: Attribute to "SweepState" and link the operator review page.

GET/legal-map/data.json

State legality open data (JSON)

Downloadable snapshot of the legality status for all 50 states plus DC, with the per-state operator count and ban effective date added in the enriched export.

Open JSON export

Response fields

generatedAt Export build timestamp (ISO 8601). The dataset version, set when the snapshot is generated, not a content-freshness claim.
lastVerified Most recent per-state verification date across the collection (ISO date).
operatorTotal Total listed operators, the denominator for each state operatorCount.
counts Aggregate status counts across states.
states Array of per-state rows (see fields below).

Record fields

code Two-letter state code.
name State name.
slug State page slug.
dbStatus Raw legal status from the data layer.
publicLabel Canonical public label (for example Not available, Limited availability).
label Short display label.
confidence Confidence rating for the status.
lastVerified Per-state last-verified date, or null when not held.
sourceCompleteness How complete the cited sourcing is for this state.
summary One-line status summary.
operatorCount Operators (of operatorTotal) currently serving this state. Added in the enriched export.
banEffectiveDate ISO date a prohibition takes or took effect, or null. Never a render-day or invented value. Added in the enriched export.

Example

{
  "generatedAt": "2026-07-08T00:00:00.000Z",
  "lastVerified": "2026-06-09",
  "operatorTotal": 182,
  "counts": {
    "available": 24,
    "limitedAvailability": 3,
    "notAvailable": 13,
    "pendingChange": 2,
    "legalUncertainty": 9,
    "mapAvailable": 35,
    "mapLimitedAvailability": 3,
    "mapNotAvailable": 13
  },
  "states": [
    {
      "code": "CA",
      "slug": "california",
      "name": "California",
      "dbStatus": "prohibited",
      "publicLabel": "not-available",
      "label": "Not available",
      "mapBucket": "not-available",
      "confidence": "high",
      "uncertaintyFlag": false,
      "lastVerified": "2026-07-08",
      "summary": "California bans sweepstakes casinos under AB 831 / Chapter 623 (signed October 11, 2025, effective January 1, 2026), imposing fines of $1,000-$25,000 and up to one year in jail, with liability extending to third-party vendors.",
      "methodologyNote": "AB 831 (Ch.623, Stat.2025)",
      "warnings": [],
      "recentChanges": [
        "January 1, 2026: AB 831 took effect in California after the October 11, 2025 signature.",
        "April 14, 2026: Re-checked current operator terms; California remained excluded from promotional play in the reviewed source set."
      ],
      "corrections": [
        "April 14, 2026: moved California's ban coverage to a source-first template with explicit affiliate-liability sourcing."
      ],
      "primarySources": [
        {
          "name": "AB 831  -  Bill Text (California Legislature)",
          "url": "https://leginfo.legislature.ca.gov/faces/billTextClient.xhtml?bill_id=202520260AB831",
          "accessedDate": "2026-04-14",
          "note": "Official California bill text for the sweepstakes-casino prohibition.",
          "sourceClass": "official-law",
          "verification": "verified-primary"
        },
        {
          "name": "California Penal Code  -  Gambling (Title 9, Part 1, Chapter 10)",
          "url": "https://leginfo.legislature.ca.gov/faces/codes_displayexpandedbranch.xhtml?tocCode=PEN&division=&title=9&part=1&chapter=10&article=",
          "accessedDate": "2026-04-14",
          "note": "Official code branch containing the gambling provisions that AB 831 amended.",
          "sourceClass": "official-law",
          "verification": "verified-primary"
        }
      ],
      "operatorSources": [
        {
          "name": "Chumba Casino Terms and Conditions",
          "url": "https://media.www.chumbacasino.com/vgwholdings89e8-vgw-prod-817c/media/260303_POL_CHU_TCs_23-1.pdf",
          "accessedDate": "2026-04-14",
          "note": "Reviewed current excluded-territory language; California remained in the excluded-state set at the last check.",
          "sourceClass": "operator-terms",
          "verification": "verified-operator"
        }
      ],
      "secondarySources": [
        {
          "name": "ZwillGen  -  California's AB 831 Bans Sweepstakes Casinos, Expands Liability to Vendors",
          "url": "https://www.zwillgen.com/gaming/californias-ab-831-bans-sweepstakes-casinos-expands-liability-vendors/",
          "accessedDate": "2026-04-14",
          "note": "Context source used to compare affiliate/vendor-liability framing against the bill text.",
          "sourceClass": "operator-terms",
          "verification": "verified-operator"
        }
      ],
      "pendingBills": [],
      "hasOfficialPrimarySource": true,
      "sourceCompleteness": "complete",
      "operatorCount": 0,
      "banEffectiveDate": "2026-01-01",
      "…": "remaining per-state fields"
    }
  ]
}

Version field: generatedAt is the export build timestamp set per request. Per-state freshness lives in each row lastVerified, and the collection-wide lastVerified is the maximum of those.

Citation: Attribute to "SweepState" and link /legal-map. State legality changes over time, so cite the per-state lastVerified.

GET/legal-map/data.csv

State legality open data (CSV)

The same per-state legality snapshot as the JSON export, as a CSV download. The operatorCount, operatorTotal, and banEffectiveDate columns are appended so existing column positions are unchanged.

Open CSV export

Columns

code Two-letter state code.
name State name.
slug State page slug.
dbStatus Raw legal status from the data layer.
publicLabel Canonical public label.
label Short display label.
confidence Confidence rating for the status.
lastVerified Per-state last-verified date, or empty when not held.
sourceCompleteness How complete the cited sourcing is.
summary One-line status summary.
operatorCount Operators serving this state. Appended column.
operatorTotal Total listed operators. Appended column.
banEffectiveDate ISO ban effective date, or empty. Appended column.

Example

code,name,slug,dbStatus,publicLabel,label,confidence,lastVerified,sourceCompleteness,summary,operatorCount,operatorTotal,banEffectiveDate
CA,California,california,prohibited,not-available,Not available,high,2026-07-08,complete,California bans sweepstakes casinos under AB 831 / Chapter 623 (signed October 11, 2025, effective January 1, 2026), imposing fines of $1,000-$25,000 and up to one year in jail, with liability extending to third-party vendors.,0,182,2026-01-01

Version field: The CSV carries no timestamp cell. Pair it with the JSON export generatedAt for a version, and read the per-row lastVerified for freshness.

Citation: Attribute to "SweepState" and link /legal-map.

GET/legal-updates/ban-timeline

US sweepstakes casino ban timeline (Dataset)

An indexable page carrying a Dataset of every source-backed US state sweepstakes-casino prohibition, ordered by the recorded chronology date. Future-dated enacted bans render as pending rows until their effective date.

Open endpoint

Response fields

State State affected by the prohibition.
Bill or citation Bill number or legal citation, when held.
Date signed Date the measure was signed, when held.
Effective date Date the prohibition takes or took effect, when held.
Current status Current status label, including pending rows for enacted future bans.
Source Link to the primary legal source, when held.

Example

{
  "state": "Washington",
  "billCitation": "RCW 9.46",
  "effectiveDate": "1973-01-01",
  "currentStatus": "prohibited",
  "source": "https://app.leg.wa.gov/rcw/default.aspx?cite=9.46"
}

Version field: The page shows a visible Data as of date sourced from the maximum real data event across the included states, never a render-day date. The Dataset schema sets dateModified from that same value.

Citation: Attribute to "SweepState" and link /legal-updates/ban-timeline. Cite the specific state page for an individual ban.

Attribution

These surfaces are offered under a Creative Commons Attribution 4.0 license. If you use the data, please credit SweepState and link the relevant page. Index scores are editorial research estimates under the published methodology, and state legality changes over time, so cite the dated source page. Not legal advice.

View the state legality map View the ban timeline dataset Read the scoring methodology

Affiliate disclosure

SweepState contains affiliate links. When you register through them, we may earn a commission at no additional cost to you. That revenue supports editorial work, documented checks, and site maintenance. Affiliate relationships do not purchase rankings, review conclusions, or page placement.

Directory and bonus listings may refresh more often than a full editorial review. Review pages change after we verify material updates.

Read full disclosure

Responsible play

Sweepstakes play should be treated as entertainment. If play is affecting your finances, time, or wellbeing, use the responsible-gaming resources linked below.

For help, call 1-800-MY-RESET (1-800-697-3738). 1-800-522-4700 remains active as an alternate National Problem Gambling Helpline access point, or use the responsible-gaming resources page.

Source: National Council on Problem Gambling. Last checked 2026-05-03. SweepState is an informational review site and does not provide counseling, treatment, crisis support, or medical advice.

National Problem Gambling Helpline:1-800-MY-RESET (1-800-697-3738)

Guide:Responsible gaming policy

Age requirement: You must meet the minimum age requirement in your state to participate. No purchase necessary to play.

<iframe src="https://sweepstate.com/embed/legal-map?ref=data&src=your-domain" title="US Sweepstakes Casino Legality Map by SweepState" width="100%" height="620" style="border:0;max-width:900px;" loading="lazy" referrerpolicy="no-referrer-when-downgrade" ></iframe> <p style="margin-top:8px;font-size:12px;color:#475569;text-align:center;">Map data by <a href="https://sweepstate.com/legal-map?ref=data-attribution&src=your-domain" target="_blank" rel="noopener noreferrer">SweepState</a>. US sweepstakes casino legality tracker.</p>

GET/api/casinos

Sweepstakes casino index (list)

Returns the scored index of tracked sweepstakes operators as JSON. Every record is the same merged operator object the review pages render, so the public score and facts match the site.

Open endpoint

Parameters

limit Maximum operators to return. Defaults to 10 when omitted.
state Two-letter state code to scope the list to operators available in that state.
featured Set to return only the featured shortlist.
search Free-text query (two or more characters) that switches the response to ranked search results.

Response fields

casinos Array of operator records (the merged factual plus editorial object).
total Count of operators in the casinos array.
query Echo of the search term. Present only on the search response.
results Ranked match metadata (id, name, score, matchedField). Present only on the search response.

Record fields

id Operator primary key, which is also the public slug.
name Operator display name.
slug URL slug, equal to id.
indexScore Canonical 0 to 10 Index score under the published methodology.
operator Parent operator or licensee, when held.
yearEstablished Launch year, when held.
... Additional public operator facts (currencies, game types, availability) as rendered on the review page.

Example

{
  "casinos": [
    {
      "id": "stake-us",
      "name": "Stake US",
      "slug": "stake-us",
      "indexScore": 9.1,
      "…": "additional public operator fields"
    }
  ],
  "total": 1
}

Version field: This list response has no envelope timestamp. Each operator record carries its own substantive editorial dates (fact-check and last-updated) sourced from the database.

Citation: Attribute to "SweepState" and link the specific review page. Index scores are editorial research estimates under the published methodology.

{ "generatedAt": "2026-07-08T00:00:00.000Z", "lastVerified": "2026-06-09", "operatorTotal": 182, "counts": { "available": 24, "limitedAvailability": 3, "notAvailable": 13, "pendingChange": 2, "legalUncertainty": 9, "mapAvailable": 35, "mapLimitedAvailability": 3, "mapNotAvailable": 13 }, "states": [ { "code": "CA", "slug": "california", "name": "California", "dbStatus": "prohibited", "publicLabel": "not-available", "label": "Not available", "mapBucket": "not-available", "confidence": "high", "uncertaintyFlag": false, "lastVerified": "2026-07-08", "summary": "California bans sweepstakes casinos under AB 831 / Chapter 623 (signed October 11, 2025, effective January 1, 2026), imposing fines of $1,000-$25,000 and up to one year in jail, with liability extending to third-party vendors.", "methodologyNote": "AB 831 (Ch.623, Stat.2025)", "warnings": [], "recentChanges": [ "January 1, 2026: AB 831 took effect in California after the October 11, 2025 signature.", "April 14, 2026: Re-checked current operator terms; California remained excluded from promotional play in the reviewed source set." ], "corrections": [ "April 14, 2026: moved California's ban coverage to a source-first template with explicit affiliate-liability sourcing." ], "primarySources": [ { "name": "AB 831 - Bill Text (California Legislature)", "url": "https://leginfo.legislature.ca.gov/faces/billTextClient.xhtml?bill_id=202520260AB831", "accessedDate": "2026-04-14", "note": "Official California bill text for the sweepstakes-casino prohibition.", "sourceClass": "official-law", "verification": "verified-primary" }, { "name": "California Penal Code - Gambling (Title 9, Part 1, Chapter 10)", "url": "https://leginfo.legislature.ca.gov/faces/codes_displayexpandedbranch.xhtml?tocCode=PEN&division=&title=9&part=1&chapter=10&article=", "accessedDate": "2026-04-14", "note": "Official code branch containing the gambling provisions that AB 831 amended.", "sourceClass": "official-law", "verification": "verified-primary" } ], "operatorSources": [ { "name": "Chumba Casino Terms and Conditions", "url": "https://media.www.chumbacasino.com/vgwholdings89e8-vgw-prod-817c/media/260303_POL_CHU_TCs_23-1.pdf", "accessedDate": "2026-04-14", "note": "Reviewed current excluded-territory language; California remained in the excluded-state set at the last check.", "sourceClass": "operator-terms", "verification": "verified-operator" } ], "secondarySources": [ { "name": "ZwillGen - California's AB 831 Bans Sweepstakes Casinos, Expands Liability to Vendors", "url": "https://www.zwillgen.com/gaming/californias-ab-831-bans-sweepstakes-casinos-expands-liability-vendors/", "accessedDate": "2026-04-14", "note": "Context source used to compare affiliate/vendor-liability framing against the bill text.", "sourceClass": "operator-terms", "verification": "verified-operator" } ], "pendingBills": [], "hasOfficialPrimarySource": true, "sourceCompleteness": "complete", "operatorCount": 0, "banEffectiveDate": "2026-01-01", "…": "remaining per-state fields" } ] }

code,name,slug,dbStatus,publicLabel,label,confidence,lastVerified,sourceCompleteness,summary,operatorCount,operatorTotal,banEffectiveDate CA,California,california,prohibited,not-available,Not available,high,2026-07-08,complete,California bans sweepstakes casinos under AB 831 / Chapter 623 (signed October 11, 2025, effective January 1, 2026), imposing fines of $1,000-$25,000 and up to one year in jail, with liability extending to third-party vendors.,0,182,2026-01-01