---
title: "Every airing in a time range"
method: GET
path: "/api/placements/calendar"
tags: ["Products / Placements / Airings"]
---

# Every airing in a time range

`GET /api/placements/calendar`

## Request

- Base URL: `https://api.payware.eu`
- URL: `https://api.payware.eu/api/placements/calendar`
- Auth: HTTP bearer

All occurrences of the merchant's placements between from and to, ordered by start time, each in its rule's time zone. The range may span at most 400 days.

## Query parameters

- `from` string, required
- `to` string, required

## Response `200`

Occurrences

## Other responses

- `400`: ERR_INVALID_DATE_FORMAT, ERR_INVALID_DATE_RANGE
- `401`: Unauthenticated - missing, malformed or expired credentials
- `403`: Forbidden - the caller is authenticated but not permitted (plan or capability gate, KYC state, or tenant scope)
- `429`: Too many requests - the caller exceeded its per-partner rate limit. Carries errorCode ERR_RATE_LIMIT_EXCEEDED and a Retry-After header, in seconds. The request was not processed, so the identical request is safe to retry once the window has passed.

---

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