# The banner

> tidekeeper's API reference: https://tidekeeper.eu/docs/api/get-sites-site-banner

`GET /api/v1/sites/{site}/banner`

The banner: what is live, the draft, and every version that was shown.

## Parameters

- `site` (in path, needed): A site's id or name

## The answer

200, `BannersView`

- `draft` (BannerView or null)
- `live` (BannerView or null)
- `own_tool` (boolean, needed): The site asks with its own tool: no banner of ours is shown.
- `site` (string, needed)
- `starting` (object, needed): What a new draft starts from.
- `versions` (list of BannerView, needed): Every version that was shown, newest first (CR-03).

## Asking

```sh
curl https://tidekeeper.eu/api/v1/sites/example.org/banner \
    -H "Authorization: Bearer $TIDEKEEPER_TOKEN"
```