---
title: "Les bandeaux à l'antenne pour une surface"
method: GET
path: "/site-banners"
tags: ["Marketing Content"]
---

# Les bandeaux à l'antenne pour une surface

`GET /site-banners`

## Request

- Base URL: `https://api.atako.ai`
- URL: `https://api.atako.ai/site-banners`
- Auth: none required

Ni brouillon, ni prévu, ni passé : la fenêtre d'affichage est appliquée côté serveur. `surface` est obligatoire — `both` est une AUDIENCE, jamais une question.

## Query parameters

- `surface` 'marketing' | 'app', required

## Response `200`

- SiteBanner[]
  - `id` string, uuid, required
  - `kind` 'marketing' | 'technical', required: Décide du ton visuel, et rien d'autre.
  - `audience` 'marketing' | 'app' | 'both', required
  - `icon` string, nullable: Nom d'icône pris dans une liste fermée (`Megaphone`, `Sparkles`, `Gift`, `Rocket`, `Info`, `TriangleAlert`, `OctagonAlert`, `Wrench`, `Clock`).
  - `message` object, required: A French base value plus optional translations. `fr` is always present; other IETF locale keys are present when translated.
    - `fr` string, required
    - `en` string
    - `de` string
    - `es` string
    - `it` string
    - `pt-BR` string
    - `nl` string
    - `pl` string
    - `sv` string
    - `da` string
    - `tr` string
    - `ja` string
    - `ko` string
  - `linkUrl` string, nullable
  - `linkLabel` object, nullable: A French base value plus optional translations. `fr` is always present; other IETF locale keys are present when translated.
    - `fr` string, required
    - `en` string
    - `de` string
    - `es` string
    - `it` string
    - `pt-BR` string
    - `nl` string
    - `pl` string
    - `sv` string
    - `da` string
    - `tr` string
    - `ja` string
    - `ko` string
  - `buttonLabel` object, nullable: A French base value plus optional translations. `fr` is always present; other IETF locale keys are present when translated.
    - `fr` string, required
    - `en` string
    - `de` string
    - `es` string
    - `it` string
    - `pt-BR` string
    - `nl` string
    - `pl` string
    - `sv` string
    - `da` string
    - `tr` string
    - `ja` string
    - `ko` string
  - `buttonUrl` string, nullable
  - `dismissible` boolean, required
  - `startsAt` string, date-time, nullable
  - `endsAt` string, date-time, nullable: Borne EXCLUSIVE.
  - `publishedAt` string, date-time
  - `createdAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `400`: Unknown surface

---

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