---
title: "Get geo restrictions for highlight"
method: GET
path: "/volleyball/highlights/geo-restrictions/{id}"
tags: ["Volleyball.Highlights"]
---

# Get geo restrictions for highlight

`GET /volleyball/highlights/geo-restrictions/{id}`

## Request

- Base URL: `https://sports.highlightly.net`
- URL: `https://sports.highlightly.net/volleyball/highlights/geo-restrictions/{id}`
- Auth: none declared. Required headers: `x-rapidapi-host`, `x-rapidapi-key`
- TypeScript: <https://skmtc.dev/highlightly/apis/sports-api-highlightly/docs/volleyball/highlights/geo-restrictions/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

> Refresh interval: Once an hour

> Note: Endpoint is not available in the Basic/Free plan.

Geo restrictions are a plague that have been around for quite a while. They restrict access to online content based on the viewers geographical location. Trying to show restricted highlights to your users can greatly hinder the viewing experience.

Each highlight has a `state` property which defines how the geo restrictions are applied.

| State       | Description   |
| ----------- | -----------   |
| No restricitons applied                 | Highlight has no restrictions applied and is available globally.            |   
| Allowed countries restriction           | Highlight is only available to users whose country code is found in the `allowedCountries` list.             |
| Blocked countries restriction           | Highlight is blocked to all users whose country code is found in the `blockedCountries` list.               |
| Unknown restrictions                    | There is no guaranteed way to define all allowed or blocked countries.            |

As presented before, certain highlights have an `embedUrl` field which can be used to directly embed the video into your website or application. The `embeddable` field specifies whether this is allowed or not.

## Path parameters

- `id` number, required

## Headers

- `x-rapidapi-host` string, required
- `x-rapidapi-key` string, required

## Response `200`

- RestrictionResponseDto
  - `state` 'No restricitons applied' | 'Allowed countries restriction' | 'Blocked countries restriction' | 'Unknown restrictions', required: Specifies which restriction rule is applied to the requested highlight. If allowed restriction is applied, read from allowedCountries field. When blocked restriction is applied, countries from blockedCountries field are applied.
  - `allowedCountries` string[], required: ISO 3166 two letter country list of allowed countries when restriction rules is in allowed state.
  - `blockedCountries` string[], required: ISO 3166 two letter country list of blocked countries. Rule list is valid when restriction rules is in blocked state.
  - `embeddable` boolean, required: Boolean flag which indicates whether highlight provider allows embedding inside web applications.

## Other responses

- `400`: Bad request descriptive error.
- `500`: Internal server error.

---

[API](https://skmtc.dev/highlightly/apis/sports-api-highlightly.md) - [All operations](https://skmtc.dev/highlightly/apis/sports-api-highlightly/llms.txt) - [OpenAPI document](https://skmtc.dev/highlightly/apis/sports-api-highlightly/revisions/c8a366d3091f?raw)