# Render the calendar widget

**Publié le** : 2026-05-12
**Catégorie** : Content

## `GET /widgets/calendar/:variableKey`

**Render the calendar widget**

Return a self-contained HTML page rendering a calendar widget,
keyed on a site variable identified by `:variableKey`. Designed
to be embedded via an `<iframe>` so the parent page does not
inherit the widget's CSS or JavaScript. Supports `locale`
(default `fr`) and `display` (`grid` or `list`, default `grid`).

### Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `variableKey` | path | string | Yes |  |


### Responses

| Status | Description |
| --- | --- |
| `200` | Successful response |
| `404` | Not found |


> **Notes:** Content type: `text/html`. Cache:
> `Cache-Control: public, max-age=3600`. Rate-limit bucket: general.
> Designed for iframe embedding; do NOT inject the raw HTML into
> the parent document.

### Examples

```html
<iframe
  src="https://api.lynkow.com/public/{siteId}/widgets/calendar/business-hours?locale=en&display=list"
  width="320" height="280"
  loading="lazy">
</iframe>
```

### Response Example

```json
"<!doctype html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"utf-8\" />\n    <title>Calendar widget</title>\n    <style>/* scoped CSS */</style>\n  </head>\n  <body>\n    <div class=\"lynkow-calendar lynkow-calendar--grid\">\n      <table>...</table>\n    </div>\n  </body>\n</html>\n"
```

---