US State Geo-Restriction Examples

Similarly to country level restrictions, we also have the ability to geo-restrict across state boundaries in the US.

Below are some example scenarios that should help you to understand how these work on the IMG Arena Streaming Platform.

Example 1: Event is allowed in the US, Licence for property is for the US

In this scenario, the event will be available to view in the whole of the USA. The Events API will not return any state-specific information, but the US will be returned as a whitelisted country.

For example, a Snooker event is whitelisted in the US and Canada, and the Operator has a license in the US.

Example events API response with restrictions=whitelist:

  {
        "id": 141728,
        "title": "Ali Carter v Adam Stefanow",
        "tournament": {
            "id": 2665,
            "name": "Welsh Open 2020",
            "property": {
                "id": 63,
                "name": "World Snooker",
                "sport": {
                    "id": 14,
                    "name": "Snooker"
                }
            }
        },
        "restrictionRequest": "whitelist",
        "countryList": [
            "US"
        ],
        "updatedAt": "2020-02-10T20:37:08+0000",
        "startDate": "2020-02-10T20:00:00+0000",
        "endDate": "2020-02-11T03:00:00+0000"
    }

Calling the Streaming API from anywhere in the US will result in a successful response, with a playback URL returned.

The Events API response with restrictions=blacklist will return all other countries.

Example 2: Event is allowed in certain US States, Licence for property is for the US

In this scenario, the event is only available in certain states for an Operator - despite having a license for the whole of the USA, this particular event is restricted to only certain states.

For example, an event is only available in New York, California and New Jersey, and the Operator has a license in the whole of the US.

Example events API response with restrictions=whitelist

{
        "id": 141728,
        "title": "Ali Carter v Adam Stefanow",
        "tournament": {
            "id": 2665,
            "name": "Welsh Open 2020",
            "property": {
                "id": 63,
                "name": "World Snooker",
                "sport": {
                    "id": 14,
                    "name": "Snooker"
                }
            }
        },
        "restrictionRequest": "whitelist",
        "countryList": [],
        "updatedAt": "2020-02-10T20:37:08+0000",
        "startDate": "2020-02-10T20:00:00+0000",
        "endDate": "2020-02-11T03:00:00+0000"
    }

Example Events API response with subRestrictions=whitelist

{
        "id": 141728,
        "title": "Ali Carter v Adam Stefanow",
        "tournament": {
            "id": 2665,
            "name": "Welsh Open 2020",
            "property": {
                "id": 63,
                "name": "World Snooker",
                "sport": {
                    "id": 14,
                    "name": "Snooker"
                }
            }
        },
        "restrictionRequest": "whitelist",
        "countryList": [],
        "subDivisionList": [
            "US-NY",
            "US-CA",
            "US-NJ"
        ],
        "updatedAt": "2020-02-10T20:37:08+0000",
        "startDate": "2020-02-10T20:00:00+0000",
        "endDate": "2020-02-11T03:00:00+0000"
    }

Calling the Streaming API from anywhere in the New York, California and New Jersey will result in a successful response, with a playback URL returned.

The example responses will return all other countries/US States when the above requests are made with the "blacklist" parameter.

If there are any US State level restrictions - the US will not show up in the country white or blacklist - as the US is neither explicitly whitelisted or blacklisted.

Example 3: Content allowed in certain US States and Countries, Licence for property is also allowed in certain US States and Countries

In this scenario, the event is available in certain states, but the Operator has a license for another set of US States.

For Example, An event is whitelisted in the US States of New York, California, New Jersey, Nevada, Florida, Nebraska, Kansas and Alabama. It is also whitelisted in France and the UK.

An Operator has a license for the property in California, New Jersey, Florida, Michigan and New Mexico. They also have a license for France.

In this scenario, an Operator will be able to view the event in the US States of California, New Jersey and Florida and France. This is because these States/Countries are the only States/Countries that the event is whitelisted and the Operator has a license.

Example events API response with restrictions=whitelist

{
        "id": 141728,
        "title": "Ali Carter v Adam Stefanow",
        "tournament": {
            "id": 2665,
            "name": "Welsh Open 2020",
            "property": {
                "id": 63,
                "name": "World Snooker",
                "sport": {
                    "id": 14,
                    "name": "Snooker"
                }
            }
        },
        "restrictionRequest": "whitelist",
        "countryList": [
            "FR"
        ],
        "updatedAt": "2020-02-10T20:37:08+0000",
        "startDate": "2020-02-10T20:00:00+0000",
        "endDate": "2020-02-11T03:00:00+0000"
    }

Example Events API response with subRestrictions=whitelist

{
        "id": 141728,
        "title": "Ali Carter v Adam Stefanow",
        "tournament": {
            "id": 2665,
            "name": "Welsh Open 2020",
            "property": {
                "id": 63,
                "name": "World Snooker",
                "sport": {
                    "id": 14,
                    "name": "Snooker"
                }
            }
        },
        "restrictionRequest": "whitelist",
        "countryList": [
            "FR"
        ],
        "subDivisionList": [
            "US-CA",
            "US-NY",
            "US-FL"
        ],
        "updatedAt": "2020-02-10T20:37:08+0000",
        "startDate": "2020-02-10T20:00:00+0000",
        "endDate": "2020-02-11T03:00:00+0000"
    }

Calling the Streaming API from anywhere in the California, New York, Florida or France will result in a successful response, with a playback URL returned.

The example responses will return all other countries/US States when the above requests are made with the "blacklist" parameter.