# How coverage is reported

> The keyless and keyed views of /v2/coverage, and what live and interrupted mean.

## One document per region, two views

GET /v2/coverage?region=<code> answers from one document per region, in two views. region missing means uk.

## Without a key

Send no Authorization and no x-api-key header. Per product, each venue and sport is live, or `interrupted_24h`: an interruption in the last 24 hours, or no rows now. There are no counts and no times. It is public: Cache-Control public, max-age=60, and Access-Control-Allow-Origin *. The /coverage page on the site reads exactly this.

Keyless:

```
curl --compressed -s "https://api.oddsrelay.io/v2/coverage?region=uk"
```

## With a key

Send either key header (an empty or invalid one is a 401, never the public view). You get your key's products that the region serves, bookmakers and exchanges apart, each with the sports it has rows for now, their event counts and `last_seen`. It is free and counts toward the flood cap.

Source: https://oddsrelay.io/docs/guides/coverage-method · the API contract: https://api.oddsrelay.io/v2/openapi.json
