---
title: "List calendar events"
method: GET
path: "/api/calendar"
tags: ["Calendar"]
---

# List calendar events

`GET /api/calendar`

## Request

- Base URL: `https://api.postproxy.dev`
- URL: `https://api.postproxy.dev/api/calendar`
- Auth: HTTP bearer

Retrieves a filtered, paginated list of social media calendar events for 2026 — public holidays, awareness days, cultural events, commerce dates, and sensitive/no-post dates. This is a public endpoint; no authentication required.

## Query parameters

- `category` string
- `type` string
- `country` string
- `tag` string
- `month` integer
- `q` string
- `from` string, date
- `to` string, date
- `page` integer
- `per_page` integer

## Response `200`

Paginated list of calendar events

- object
  - `total` integer: Total number of events matching the filters
  - `page` integer: Current page number
  - `per_page` integer: Number of results per page
  - `filters` object: Echo of active filters applied to the request
  - `data` CalendarEvent[]: Array of event objects
    - `date` string, date: Event date (YYYY-MM-DD)
    - `name` string: Event name
    - `type` 'public_holiday' | 'fun_holiday' | 'awareness_day' | 'cultural_event' | 'sporting_event' | 'commerce_event' | 'religious_event' | 'seasonal' | 'remembrance': Event type
    - `category` 'post_trigger' | 'sensitive' | 'no_post': post_trigger: good opportunity to post; sensitive: post with care; no_post: brands should stay silent or share only respectful acknowledgment
    - `countries` string[], nullable: Country codes (ISO 3166-1 alpha-2) where applicable, or null for global events
    - `tags` string[]: Descriptive tags for filtering
    - `posting_tip` string, nullable: Optional social media posting guidance

---

[API](https://skmtc.dev/postproxy/apis/postproxy-social-media-api.md) - [All operations](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/llms.txt) - [OpenAPI document](https://skmtc.dev/postproxy/apis/postproxy-social-media-api/revisions/d54482ac4ce7?raw)